Zasób: AudienceList
Lista odbiorców to lista użytkowników znajdujących się na liście odbiorców w momencie jej tworzenia. Każda grupa odbiorców może mieć wiele list odbiorców utworzonych na potrzeby różnych dni.
Zapis JSON |
---|
{ "name": string, "audience": string, "audienceDisplayName": string, "dimensions": [ { object ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Identyfikator. Nazwa zasobu listy odbiorców przypisana podczas tworzenia. Ta nazwa zasobu identyfikuje ten zasób ( Format: |
audience |
Wymagane. Nazwa zasobu listy odbiorców. Ta nazwa zasobu określa listę odbiorców i jest udostępniana przez interfejsy Analytics Data & Admin API. Format: |
audienceDisplayName |
Tylko dane wyjściowe. Wyświetlana nazwa opisowa dla tej listy odbiorców. Na przykład „Kupujący”. |
dimensions[] |
Wymagane. Wymiary żądane i wyświetlone w odpowiedzi na zapytanie. |
creationQuotaTokensCharged |
Tylko dane wyjściowe. Łączna liczba tokenów limitu opłaconych podczas tworzenia listy odbiorców. Ta liczba tokenów jest uzależniona od aktywności ze stanu |
state |
Tylko dane wyjściowe. Obecny stan tej listy odbiorców. |
beginCreatingTime |
Tylko dane wyjściowe. Czas wywołania metody AudienceLists.create i początku stanu Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
rowCount |
Tylko dane wyjściowe. Łączna liczba wierszy w wyniku listy odbiorców. |
errorMessage |
Tylko dane wyjściowe. Komunikat o błędzie pojawia się, gdy nie uda się utworzyć listy odbiorców. Częstą przyczyną takich problemów jest wyczerpanie limitu. |
percentageCompleted |
Tylko dane wyjściowe. Procent ukończenia eksportu list odbiorców z zakresu od 0 do 100. |
recurringAudienceList |
Tylko dane wyjściowe. Cykliczna lista odbiorców, która utworzyła daną listę odbiorców. Cykliczne listy odbiorców tworzą listy odbiorców codziennie. Jeśli listy odbiorców są tworzone bezpośrednio, nie będą miały powiązanej cyklicznej listy odbiorców, a to pole będzie puste. |
webhookNotification |
Opcjonalnie. Umożliwia skonfigurowanie wysyłania powiadomień webhook z interfejsu Google Analytics Data API na serwer webhooka. Korzystanie z webhooków jest opcjonalne. Jeśli lista odbiorców jest gotowa do użycia, musisz ją przeprowadzić w tym interfejsie API, jeśli jest nieużywana. Webhooki umożliwiają wysyłanie powiadomień do Twoich serwerów i pozwalają uniknąć konieczności odpytywania. Do webhooka zostanie wysłane jedno lub dwa żądania POST. Pierwsze żądanie POST zostanie natychmiast wysłane z informacją, że nowo utworzona lista odbiorców jest w stanie TWORZENIA. Drugie żądanie POST jest wysyłane po zakończeniu tworzenia listy odbiorców (w stanie AKTYWNA lub NIEUDANA). Jeśli żądanie identycznych list odbiorców nastąpi w krótkim czasie, druga i kolejna lista odbiorców może zostać wyświetlona z pamięci podręcznej. W takim przypadku metoda tworzenia listy odbiorców może zwrócić, że lista odbiorców jest już AKTYWNA. W takiej sytuacji do webhooka zostanie wysłane tylko jedno żądanie POST. |
Stan
Lista odbiorców jest obecnie w tym stanie.
Wartości w polu enum | |
---|---|
STATE_UNSPECIFIED |
Nieokreślony stan nigdy nie będzie używany. |
CREATING |
Obecnie trwa tworzenie listy odbiorców i będzie dostępna w przyszłości. Tworzenie następuje bezpośrednio po wywołaniu AudienceLists.create. |
ACTIVE |
Lista odbiorców jest w pełni utworzona i gotowa do wysyłania zapytań. Lista odbiorców jest aktualizowana asynchronicznie w wyniku żądania. Następuje to po jakimś czasie (np. 15 minutach) po pierwszym wywołaniu tworzenia. |
FAILED |
Nie udało się utworzyć listy odbiorców. Możliwe, że ponowne wysłanie prośby o tę listę odbiorców się powiedzie. |
Metody |
|
---|---|
|
Tworzy listę odbiorców do późniejszego pobrania. |
|
Eksportuje listę odbiorców zawierającą użytkowników do Arkuszy Google. |
|
Pobiera metadane konfiguracji określonej listy odbiorców. |
|
Wyświetla listę wszystkich list odbiorców związanych z usługą. |
|
Pobiera listę odbiorców użytkowników. |