Operacje subskrypcji aplikacji
Monetization by monday oferuje dwa modele cenowe aplikacji: oparty na funkcjach i oparty na liczbie miejsc. W przypadku modelu opartego na funkcjach ważne jest śledzenie liczby operacji wykonywanych przez aplikację, aby nie przekroczyły przyznanego limitu.
Obiekt app_subscription_operations oraz powiązane z nim zapytania i mutacje pozwalają śledzić użycie, zliczając operacje według typu (kind) i konta. W przypadku subskrypcji rocznych i miesięcznych licznik zeruje się co miesiąc w dniu odnowienia subskrypcji. Na przykład jeśli subskrypcja odnawia się co roku 15. dnia miesiąca, licznik będzie zerować się 15. dnia każdego miesiąca.
Za pomocą mutacji increase_app_subscription_operations możesz zwiększyć licznik operacji na podstawie użycia na koncie, a następnie odczytać zaktualizowane wartości za pomocą zapytania app_subscription_operations. Te zapytania i mutacje działają tylko z tokenami dostępu wygenerowanymi dla aplikacji, a konto musi mieć aktywną subskrypcję aplikacji. Tokeny dostępu dla deweloperów nie będą działać.
Zapytania
Pobieranie operacji subskrypcji aplikacji
- Zwraca obiekt zawierający liczbę operacji dla aplikacji korzystających z modelu opartego na funkcjach
- Można go odpytywać tylko bezpośrednio w korzeniu zapytania; nie można go zagnieżdżać w innym zapytaniu
query {
app_subscription_operations(kind: "image_scan") {
counter_value
period_key
}
}
import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });
const query = "query ($operationKind: String!) { app_subscription_operations (kind: $operationKind) { counter_value period_key }}"
const variables = {
operationKind: "image_scan",
};
const response = await mondayApiClient.request(query, variables);
Argumenty
| Argument | Typ | Opis |
|---|---|---|
| kind | String |
Nazwa operacji. |
Pola
| Pole | Typ | Opis |
|---|---|---|
| app_subscription | [AppSubscription] |
Szczegóły subskrypcji aplikacji na koncie. |
| counter_value | Int |
Nowa wartość licznika. Licznik zeruje się na początku każdego nowego okresu subskrypcji aplikacji. |
| kind | String! |
Nazwa operacji. |
| period_key | String |
Unikatowy identyfikator okresu (powiązany z okresami subskrypcji). |
Mutacje
Zwiększanie liczby operacji w subskrypcji aplikacji
Zwiększa licznik dla określonej operacji. Zwraca obiekt AppSubscriptionOperationsCounter.
Jeśli dla przekazanego tokena nie istnieje aktywna subskrypcja, zwróci błąd.
mutation {
increase_app_subscription_operations(
kind: "image_scan"
increment_by: 2
){
counter_value
}
}
import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });
const query = "mutation ($operationKind: String!, $value: Int!) { increase_app_subscription_operations (kind: $operationKind, increment_by: $value) { counter_value }}"
const variables = {
operationKind: "image_scan",
value: 2
};
const response = await mondayApiClient.request(query, variables);
Argumenty
Jeśli pominiesz te argumenty, domyślnie zostanie użyta globalna wartość kind, a licznik zwiększy się o 1.
| Argument | Typ | Opis |
|---|---|---|
| increment_by | Int |
Wartość, o którą ma zostać zwiększony licznik. Musi być liczbą dodatnią. |
| kind | String |
Ciąg alfanumeryczny o długości do 14 znaków, który może zawierać symbole - i _. |