---
metadata:
- name: generator
content: Diplodoc Platform v5.66.1
- property: og:type
content: article
- property: article:section
content: Интеграция с другими сервисами
- property: og:title
content: Интеграция Трекера с Cloud Functions
- property: article:tag
content: Техническая инструкция
alternate:
- https://yandex.ru/support/tracker/en/tutorials/tracker-cloud-function.md
- https://yandex.ru/support/tracker/ru/tutorials/tracker-cloud-function.md
- href: https://yandex.ru/support/tracker/en/tutorials/tracker-cloud-function.md
type: text/markdown
title: Markdown version
- href: https://yandex.ru/support/tracker/en/llms.txt?revision=r22057024
rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/en/llms.txt?revision=r22057024
# Integrating Yandex Tracker with Cloud Functions
Learn how to integrate Yandex Tracker with Cloud Functions to copy time spent entries from sub-issues to their parent issue.
When the trigger fires, the function adds the latest time spent entry from the sub-issue to its parent issue.
{% note warning "Example limitations" %}
The function does not recalculate the total time spent across all sub-issues. Updates and deletions of existing entries are not synchronized. Invoking the function again for the same entry may add a duplicate to the parent issue.
{% endnote %}
To configure copying time spent entries:
1. [Register an OAuth application and get an access token](#register-app).
1. [Get an organization ID to access the API](#get-tracker-id).
1. [Create a Cloud Functions function](#create-function).
1. [Set up a trigger](#setup-trigger).
1. [Test out automatic data updates](#test-updates).
## Getting started {#before-you-begin}
{% note info "" %}
This scenario is intended for the external Yandex Tracker service with a Yandex 360 for Business organization. For Yandex Cloud organizations and the internal Tracker service, you will need to adapt the function code.
{% endnote %}
To run the scenario, you will need:
* A Yandex Cloud account with a billing account and a [role](https://yandex.cloud/en/docs/organization/security/index#service-roles) of at least `organization-manager.admin`.
* A Yandex Tracker account with a Yandex 360 for Business organization.
Sign up for Yandex Cloud and create a billing account:
1. Go to the [management console](https://console.cloud.yandex.com) and log in to Yandex Cloud or create an account if you do not have one yet.
1. On the **[Billing](https://billing.cloud.yandex.com/)** page, make sure you have a [billing account](https://yandex.cloud/en/docs/billing/concepts/billing-account) activated and its status is `ACTIVE` or `TRIAL_ACTIVE`. If you do not have a billing account, [create one](https://yandex.cloud/en/docs/billing/quickstart).
If you have an active billing account, you can create or select a folder on the [cloud page](https://console.yandex.cloud/cloud) to host your infrastructure.
[Learn more about clouds and folders](https://yandex.cloud/en/docs/resource-manager/concepts/resources-hierarchy).
### Required paid resources {#paid-resources}
The infrastructure maintenance fee covers the cost of using this function (see [Cloud Functions pricing](https://yandex.cloud/en/docs/functions/pricing)).
If you no longer need the resources you created, [delete them](#clear-out).
## Register an OAuth application and get an access token {#register-app}
Register an OAuth application and get a token by following the [Tracker API access instructions](https://yandex.ru/support/tracker/en/api/access.md#about_OAuth). Save the token. You will need it to create the function.
## Get an organization ID to access the API {#get-tracker-id}
1. Go to [Tracker](https://tracker.yandex.ru/). Click **Log in to Tracker**.
1. In the right-hand panel, click **Administration**.
1. Under **Access and payment**, click **Organizations**.
1. Under **Yandex 360 for businesses**, copy and save your organization ID. You'll need it to create a function.
## Create a Cloud Functions function {#create-function}
1. Go to the [management console](https://console.cloud.yandex.com).
1. In the top-left corner, click  **All services**.
1. Select **Serverless computing** → **Cloud Functions**.
1. Click **Create function**.
1. Enter a function name, e.g., `timeupdater`.
1. Click **Create**.
1. In the **Editor** window that opens, select `Python / 3.12` runtime environment.
1. Click **Next**.
1. In the **Method** field, click **ZIP archive**.
1. Attach a [test archive](https://github.com/yandex-cloud-examples/yc-tracker-summarize-spent/blob/main/build/tracker-summarize-spent.zip).
1. In the **Entry point** field, specify `index.handler`.
1. Go to **Parameters** and in the **Environment variables** field, add:
* `ORG`: Yandex 360 for Business organization ID
* `TOKEN`: Application access token
1. Click **Save changes**.
1. Wait for the page to load. Next, in the **Link to invoke** field, copy and save the function invocation link.
Here is an example of such a link:
```
https://functions.yandexcloud.net/d4e94uav3108********
```
1. Enable the **Public function** option.
## Set up a trigger {#setup-trigger}
### Create a queue
1.
On the left panel, click  **Queues** → **Create queue**. {#create-web}
1. Select a queue template, e.g., **Basic development model**.
1. Enter a name, e.g., `Function Test`.
1. Click **Create**.
### Create a trigger
1. In the top-right corner of the queue page, click  **Queue settings**.
1. On the left-hand panel, select **Automation** → **Triggers** and click **Create trigger**.
1. In the **Name** field, enter a trigger name, e.g., `timeupdater`.
1. Under **Conditions**, select **Time Tracking** → **Time Spent** and set the **Field value changed** comparison operation.
1. Under **Trigger actions**, select **HTTP request**.
1. In the form that opens, select the `POST` request method.
The function in the test archive also supports the `GET` method.
1. In the **Address** field, enter:
```
https://functions.yandexcloud.net/?id={{issue.key}}
```
Where `https://functions.yandexcloud.net/` is the function invocation link you saved when creating the function.
Example:
```
https://functions.yandexcloud.net/d4e94uav3108********?id={{issue.key}}
```
1. Click **Create**.
## Test out automatic data updates {#test-updates}
### Create issues
1. Create a parent issue to receive time spent entries from its sub-issues:
1. On the `Function Test` queue page, click **Create issue**.
1. In the form that opens, in the **Issue name** field, enter an issue name, e.g., `Parent Task`.
1. Click **Create**.
1. Create sub-issues:
1. In the top right corner of the `Parent Task` issue page, select **Add sub-issue** in the **Actions** menu.
1. In the form that opens, in the **Issue name** field, enter a sub-issue name, e.g., `Subtask-1`.
1. In the same way, create another sub-issue or multiple sub-issues named `Subtask-2`, `Subtask-3`, and so on.
### Enter time spent values for the sub-issues
1. Go to the `Subtask-1` sub-issue page and select **Add time spent** from the **Actions** menu in the top right corner.
1. In the window that opens, specify any time value in the **Time Spent** field. For example, you can enter `1h25m`.
1. In the same way, add time spent values for the other sub-issues.
### Check if the function works correctly
1. Go to the `Parent Task` issue page.
1. In the issue properties, make sure that the **Time Spent** field under **Time Tracking** includes the time you specified in the sub-issue.
## How to delete the resources you created {#clear-out}
To stop paying for the resources you created, [delete the Cloud Functions function](https://yandex.cloud/en/docs/functions/operations/function/function-delete).