Vytvorenie cieľa

Tento koncový bod vám umožňuje automatizovať proces vytvárania cieľov v aplikácii Beenia prostredníctvom integračných nástrojov. Môžete ho použiť na jednoduché vytváranie cieľov s definovanými parametrami.

Žiadosť

• Metóda: PRÍSPEVOK
• Cesta: /external/v0/zapier/webhooks/ciele
• hlavička:

• KĽÚČ X: Kľúč API pre autentifikáciu.

• Vstupný objekt (vo formáte JSON), ktorý obsahuje nasledujúce polia:

• ID tímu(číslo):

• Identifikátor tímu, ku ktorému cieľ patrí.
• Povinné pole.

• názov(reťazec): Názov cieľa.
• popis(reťazec): Popis cieľa.
• Typ cieľa(reťazec): Typ cieľa.

• Aktivita (AKTIVITA) alebo metrický (METRICKÝ) cieľ.

• desatinné čísla(číslo): Počet desatinných miest pre hodnoty cieľa.

• Iba pre metrické ciele.

• Cieľová hodnota(desatinné číslo): Hodnota cieľa.

• Iba pre metrické ciele.

• hodnota(desatinné číslo): Súčasná hodnota cieľa.

• Iba pre metrické ciele.

• MetricUnit(reťazec): Merná jednotka pre cieľovú metriku.

• Iba pre metrické ciele.

Odpoveď

Po úspešnom vytvorení cieľa bude odpoveď vo formáte JSON a bude obsahovať potvrdenie o vytvorení cieľa spolu s nasledujúcimi informáciami:

{

„name“: „Testovací názov cieľa“,

„description“: „Popis cieľa“,

„StartDate“: null,

„EndDate“: null,

„SortOrder“: 362,

„ParentGoalid“: nula,

„GoalType“: „AKTIVITA“,

„ID“: 79098,

„state“: „OTVORENÉ“,

„Status ID“: 0,

„Status Name“: null,

ID tímu: 20500147,

„teamName“: „Testovanie názvu tímu“,

„vlastník“: 13450875,

„OwnerName“: „John Dark“,

„CreateDat“: „2023-09-18H 07:23:17.815 Z“,

„cedent“: [],

„nájomca“: 409785,

„metric“: null,

„delete“: false,

„CalcnumopenSubGoals“: 0

}

Popis atribútov:

• ID: Jedinečný identifikátor cieľa v systéme.
• názov: Pole obsahujúce názov cieľa. Je to reťazec, ktorý popisuje, o čom je cieľ.
• popis: Obsahuje popis cieľa. Je to textový reťazec, ktorý poskytuje popis cieľa.
• Dátum začiatku: Obsahuje dátum začiatku cieľa. Ak je hodnota nulová, znamená to, že cieľ nemá určený dátum začiatku.
• Dátum ukončenia: Toto pole obsahuje dátum ukončenia cieľa. Ak je hodnota nulová, znamená to, že cieľ nemá určený dátum ukončenia.
• TriediťObjednávka: Číslo, ktoré určuje poradie cieľa v zozname cieľov alebo hierarchickom strome cieľov.
• ParentGoalid: Identifikátor nadradeného cieľa, ak je cieľ súčasťou hierarchie cieľov. Ak nie je súčasťou hierarchie, má nulovú hodnotu.
• Typ cieľa: Definuje typ cieľa. Môže mať hodnoty „AKTIVITA“ a „METRICA“.
• štát: Definuje stav cieľa. Stav môže byť „OTVORENÝ“ alebo „ZATVORENÝ“ v závislosti od toho, či je cieľ aktívny alebo uzavretý.
• StatusID: Obsahuje identifikátor stavu cieľa.
• Názov stavu: Obsahuje názov stavu cieľa.
• ID tímu: Identifikátor tímu alebo skupiny, do ktorej cieľ patrí.
• VlastníRid: Pole obsahujúce identifikátor vlastníka cieľa.
• CreateDat: Toto pole obsahuje dátum a čas vytvorenia cieľa.
• nadobúdateľ: Toto pole môže obsahovať informácie o pridelených jednotlivcoch, ktorí sú zodpovední za dosiahnutie cieľa.
• nájomca: Toto pole obsahuje identifikátor nájomcu alebo organizácie spojenej s cieľom.
• metrická: Toto pole obsahuje metriku použitú na meranie cieľa.
• MetricUnit: Jednotky metriky.

• desatinné čísla: Počet desatinných miest pre metriku.
• Cieľová hodnota: Cieľová hodnota metriky.
• hodnota: Aktuálna hodnota metriky.
• ID: Jedinečný identifikátor metriky.
• GoalID: Identifikátor cieľa, ku ktorému táto metrika patrí.
• Synchronizovanáhodnota: Informácie o tom, či je metrická hodnota synchronizovaná (false označuje, že nie je synchronizovaná).
• Zdroj údajov: Externý zdroj údajov pre metriku.
• HubspotTyp dát: Typ údajov metriky v systéme HubSpot.
• SyncDataKey: Kľúč pre synchronizáciu údajov metriky.
• LastSynCat: Dátum a čas poslednej synchronizácie metrických údajov.
• postavenie: Metrický stav.

• vymazaný: Identifikátor toho, či je cieľ označený ako vymazaný (true) alebo nie (false).
• CalcnumopenPodgóly: Toto číslo označuje množstvo otvorených čiastkových cieľov, ktoré sú súčasťou tohto cieľa.

‍

‍

‍