Package google.ads.datamanager.v1

Indeks

IngestionService

Usługa do wysyłania danych o odbiorcach do obsługiwanych miejsc docelowych.

IngestAudienceMembers

rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)

Przesyła listę zasobów AudienceMember do podanego Destination.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
IngestEvents

rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)

Przesyła listę zasobów Event z podanego pliku Destination.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
RemoveAudienceMembers

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

Usuwa listę zasobów AudienceMember z podanego zasobu Destination.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
RetrieveRequestStatus

rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse)

Pobiera stan żądania na podstawie jego identyfikatora.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager

MarketingDataInsightsService

Usługa zwracająca statystyki dotyczące danych marketingowych.

Ta funkcja jest dostępna tylko dla partnerów danych.

RetrieveInsights

rpc RetrieveInsights(RetrieveInsightsRequest) returns (RetrieveInsightsResponse)

Pobiera dane analityczne dotyczące marketingu dla danej listy użytkowników.

Ta funkcja jest dostępna tylko dla partnerów danych.

Nagłówki autoryzacji:

Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:

  • login-account: (Opcjonalnie) Nazwa zasobu konta, na którym konto Google powiązane z danymi logowania jest użytkownikiem. Jeśli nie jest ustawiony, przyjmuje się domyślnie konto żądania. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opcjonalnie) Nazwa zasobu konta z utworzonym połączeniem z usługą login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager

PartnerLinkService

Usługa do zarządzania linkami partnerów.

UserListDirectLicenseService

Usługa do zarządzania licencjami bezpośrednimi na listy użytkowników. Usuwanie nie jest obsługiwaną operacją w przypadku UserListDirectLicenses. Aby dezaktywować licencję, dzwoniący powinni zaktualizować jej stan na DISABLED.

Ta funkcja jest dostępna tylko dla partnerów danych.

CreateUserListDirectLicense

rpc CreateUserListDirectLicense(CreateUserListDirectLicenseRequest) returns (UserListDirectLicense)

Tworzy licencję bezpośrednią na listę użytkowników.

Ta funkcja jest dostępna tylko dla partnerów danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
GetUserListDirectLicense

rpc GetUserListDirectLicense(GetUserListDirectLicenseRequest) returns (UserListDirectLicense)

Pobiera licencję bezpośrednią na listę użytkowników.

Ta funkcja jest dostępna tylko dla partnerów danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
ListUserListDirectLicenses

rpc ListUserListDirectLicenses(ListUserListDirectLicensesRequest) returns (ListUserListDirectLicensesResponse)

Wyświetla wszystkie licencje bezpośrednie na listy użytkowników należące do konta nadrzędnego.

Ta funkcja jest dostępna tylko dla partnerów danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
UpdateUserListDirectLicense

rpc UpdateUserListDirectLicense(UpdateUserListDirectLicenseRequest) returns (UserListDirectLicense)

Aktualizuje licencję bezpośrednią na listę użytkowników.

Ta funkcja jest dostępna tylko dla partnerów danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager

UserListGlobalLicenseService

Usługa do zarządzania globalnymi licencjami na listy użytkowników. Usuwanie nie jest obsługiwaną operacją w przypadku UserListGlobalLicenses. Aby dezaktywować licencję, dzwoniący powinni zaktualizować jej stan na DISABLED.

Ta funkcja jest dostępna tylko dla partnerów danych.

CreateUserListGlobalLicense

rpc CreateUserListGlobalLicense(CreateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Tworzy globalną licencję na listę użytkowników.

Ta funkcja jest dostępna tylko dla partnerów danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
GetUserListGlobalLicense

rpc GetUserListGlobalLicense(GetUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Pobiera globalną licencję na listę użytkowników.

Ta funkcja jest dostępna tylko dla partnerów danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
ListUserListGlobalLicenseCustomerInfos

rpc ListUserListGlobalLicenseCustomerInfos(ListUserListGlobalLicenseCustomerInfosRequest) returns (ListUserListGlobalLicenseCustomerInfosResponse)

Zawiera wszystkie informacje o klientach na potrzeby globalnej licencji na listę klientów.

Ta funkcja jest dostępna tylko dla partnerów danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
ListUserListGlobalLicenses

rpc ListUserListGlobalLicenses(ListUserListGlobalLicensesRequest) returns (ListUserListGlobalLicensesResponse)

Wyświetla wszystkie globalne licencje na listy użytkowników należące do konta nadrzędnego.

Ta funkcja jest dostępna tylko dla partnerów danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
UpdateUserListGlobalLicense

rpc UpdateUserListGlobalLicense(UpdateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Aktualizuje globalną licencję na listę użytkowników.

Ta funkcja jest dostępna tylko dla partnerów danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager

UserListService

Usługa do zarządzania zasobami UserList.

CreateUserList

rpc CreateUserList(CreateUserListRequest) returns (UserList)

Tworzy listę użytkowników.

Nagłówki autoryzacji:

Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:

  • login-account: (Opcjonalnie) Nazwa zasobu konta, na którym konto Google powiązane z danymi logowania jest użytkownikiem. Jeśli nie jest ustawiony, przyjmuje się domyślnie konto żądania. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opcjonalnie) Nazwa zasobu konta z utworzonym połączeniem z usługą login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
DeleteUserList

rpc DeleteUserList(DeleteUserListRequest) returns (Empty)

Usuwa listę użytkowników.

Nagłówki autoryzacji:

Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:

  • login-account: (Opcjonalnie) Nazwa zasobu konta, na którym konto Google powiązane z danymi logowania jest użytkownikiem. Jeśli nie jest ustawiony, przyjmuje się domyślnie konto żądania. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opcjonalnie) Nazwa zasobu konta z utworzonym połączeniem z usługą login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
GetUserList

rpc GetUserList(GetUserListRequest) returns (UserList)

Pobiera listę użytkowników.

Nagłówki autoryzacji:

Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:

  • login-account: (Opcjonalnie) Nazwa zasobu konta, na którym konto Google powiązane z danymi logowania jest użytkownikiem. Jeśli nie jest ustawiony, przyjmuje się domyślnie konto żądania. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opcjonalnie) Nazwa zasobu konta z utworzonym połączeniem z usługą login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
ListUserLists

rpc ListUserLists(ListUserListsRequest) returns (ListUserListsResponse)

Wyświetla listę UserLists.

Nagłówki autoryzacji:

Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:

  • login-account: (Opcjonalnie) Nazwa zasobu konta, na którym konto Google powiązane z danymi logowania jest użytkownikiem. Jeśli nie jest ustawiony, przyjmuje się domyślnie konto żądania. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opcjonalnie) Nazwa zasobu konta z utworzonym połączeniem z usługą login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager
UpdateUserList

rpc UpdateUserList(UpdateUserListRequest) returns (UserList)

Aktualizuje listę użytkowników.

Nagłówki autoryzacji:

Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:

  • login-account: (Opcjonalnie) Nazwa zasobu konta, na którym konto Google powiązane z danymi logowania jest użytkownikiem. Jeśli nie jest ustawiony, przyjmuje się domyślnie konto żądania. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opcjonalnie) Nazwa zasobu konta z utworzonym połączeniem z usługą login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/datamanager

AdIdentifiers

Identyfikatory i inne informacje używane do dopasowywania zdarzenia konwersji do innej aktywności online (np. kliknięć reklam).

Pola
session_attributes

string

Opcjonalnie. Atrybuty sesji na potrzeby atrybucji i modelowania zdarzeń.
gclid

string

Opcjonalnie. Identyfikator kliknięcia Google (gclid) powiązany z tym zdarzeniem.
gbraid

string

Opcjonalnie. Identyfikator kliknięcia w przypadku kliknięć powiązanych ze zdarzeniami w aplikacji pochodzącymi z urządzeń z systemem iOS od wersji 14.
wbraid

string

Opcjonalnie. Identyfikator kliknięcia w przypadku kliknięć powiązanych ze zdarzeniami w witrynie pochodzącymi z urządzeń z systemem iOS od wersji 14.
landing_page_device_info

DeviceInfo

Opcjonalnie. Informacje zebrane o używanym urządzeniu (jeśli takie jest) w momencie wejścia do witryny reklamodawcy po interakcji z reklamą.
mobile_device_id

string

Opcjonalnie. Identyfikator wyświetlania reklam mobilnych dla reklamodawców. W przypadku iOS będzie to IDFA, w przypadku Androida – AdID, a w przypadku innych platform – identyfikatory dla reklamodawców.
dclid

string

Opcjonalnie. Identyfikator kliknięcia w reklamie displayowej powiązany z tym zdarzeniem.
impression_id

string

Opcjonalnie. Identyfikator wyświetlenia powiązany z tym zdarzeniem.
match_id

string

Opcjonalnie. Pole identyfikatora dopasowania używane do łączenia tego zdarzenia z poprzednim zdarzeniem.
encrypted_user_ids[]

EncryptedUserId

Opcjonalnie. Dowolna liczba zaszyfrowanych identyfikatorów użytkowników.

AddressInfo

Informacje o adresie użytkownika.

Pola
given_name

string

Wymagane. Imię użytkownika zapisane małymi literami, bez znaków interpunkcyjnych, bez spacji na początku i na końcu, zahaszowane za pomocą SHA-256.
family_name

string

Wymagane. Nazwisko użytkownika (w całości małymi literami, bez znaków interpunkcyjnych, bez spacji na początku i na końcu, zahaszowane za pomocą SHA-256).
region_code

string

Wymagane. Dwuliterowy kod regionu w formacie ISO-3166-1 alpha-2 adresu użytkownika.
postal_code

string

Wymagane. Kod pocztowy w adresie użytkownika.

ZakresWieku

przedziały wiekowe grup demograficznych,

Wartości w polu enum
AGE_RANGE_UNSPECIFIED Nie określono.
AGE_RANGE_UNKNOWN Brak informacji.
AGE_RANGE_18_24 w wieku od 18 do 24 lat,
AGE_RANGE_25_34 w wieku 25–34 lat,
AGE_RANGE_35_44 w wieku 35–44 lat,
AGE_RANGE_45_54 w wieku 45–54 lat,
AGE_RANGE_55_64 55–64 lata
AGE_RANGE_65_UP 65 lat i więcej.

AudienceMember

Odbiorca, który ma być poddany operacji.

Pola
destination_references[]

string

Opcjonalnie. Określa, na którą Destination ma zostać przekierowany odbiorca.
consent

Consent

Opcjonalnie. Ustawienie zgody użytkownika.
Pole zbiorcze data. Rodzaj danych identyfikacyjnych, na których ma zostać wykonane działanie. data może mieć tylko jedną z tych wartości:
user_data

UserData

Dane przekazywane przez użytkowników, które identyfikują użytkownika.
pair_data

PairData

Identyfikatory dopasowywania danych o tożsamości użytkowników (PAIR).

Ta funkcja jest dostępna tylko dla partnerów danych.
mobile_data

MobileData

dane identyfikujące urządzenia mobilne użytkownika;
user_id_data

UserIdData

Dane związane z unikalnymi identyfikatorami użytkownika zdefiniowanymi przez reklamodawcę.
ppid_data

PpidData

Dane związane z identyfikatorami podawanymi przez wydawców.

Ta funkcja jest dostępna tylko dla partnerów danych.
composite_data

CompositeData

Grupa wielu typów identyfikatorów.

AwsWrappedKeyInfo

Klucz szyfrowania danych obudowany przez klucz AWS KMS.

Pola
key_type

KeyType

Wymagane. Typ algorytmu użytego do zaszyfrowania danych.
role_arn

string

Wymagane. Nazwa zasobu Amazon (ARN) roli uprawnień przyjmowanej na potrzeby dostępu do odszyfrowywania KMS. Powinien mieć format arn:{partition}:iam::{account_id}:role/{role_name}
kek_uri

string

Wymagane. Identyfikator URI klucza AWS KMS używanego do odszyfrowywania klucza DEK. Powinien mieć format arn:{partition}:kms:{region}:{account_id}:key/{key_id} lub aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id}
encrypted_dek

string

Wymagane. Zaszyfrowany klucz szyfrujący dane zakodowany w formacie base64.

KeyType

Typ algorytmu użytego do zaszyfrowania danych.

Wartości w polu enum
KEY_TYPE_UNSPECIFIED Nieokreślony typ klucza. Nigdy nie należy go używać.
XCHACHA20_POLY1305 Algorytm XChaCha20-Poly1305

Punkt odniesienia

Kryteria bazowe, z którymi porównywane są statystyki.

Pola
Pole zbiorcze baseline. Lokalizacja bazowa, z którą porównywane są statystyki. baseline może mieć tylko jedną z tych wartości:
baseline_location

Location

Lokalizacja bazowa żądania. Lokalizacja bazowa to lista regionów połączonych operatorem LUB.
location_auto_detection_enabled

bool

Jeśli ustawisz wartość „true”, usługa spróbuje automatycznie wykryć lokalizację bazową dla statystyk.

Lokalizacja

Lokalizacja bazowa żądania. Lokalizacja bazowa znajduje się na liście OR kodów regionów w formacie ISO 3166-1 alfa-2 dla żądanych regionów.

Pola
region_codes[]

string

Lista kodów regionów w formacie ISO 3166-1 alfa-2.

CartData

Dane koszyka powiązane ze zdarzeniem.

Pola
merchant_id

string

Opcjonalnie. Identyfikator w Merchant Center powiązany z produktami.
merchant_feed_label

string

Opcjonalnie. Etykieta pliku danych Merchant Center powiązana z plikiem danych produktów.
merchant_feed_language_code

string

Opcjonalnie. Kod języka w formacie ISO 639-1 powiązany z plikiem danych Merchant Center, w którym przesyłane są Twoje produkty.
transaction_discount

double

Opcjonalnie. Suma wszystkich rabatów powiązanych z transakcją.
items[]

Item

Opcjonalnie. Lista produktów powiązanych ze zdarzeniem.
coupon_codes[]

string

Opcjonalnie. Lista kodów kuponów zastosowanych w koszyku. Kody kuponów na poziomie koszyka i produktu są niezależne od siebie.

Jeśli zdarzenie dotyczy miejsca docelowego Google Analytics, podaj tylko jeden kod kuponu. Google Analytics ignoruje dodatkowe kody kuponów.

CompositeData

Dane złożone zawierające identyfikatory i powiązane dane użytkownika. Trzeba określić co najmniej jedną z tych właściwości: user_data lub ip_data.

Pola
user_data

UserData

Opcjonalnie. Dane przekazywane przez użytkowników, które identyfikują użytkownika.
ip_data[]

IpData

Opcjonalnie. Dane adresów IP reprezentujące interakcje klientów użyte do utworzenia listy odbiorców.

Ustawienia zgody użytkownika wymaganej przez akt o rynkach cyfrowych (DMA).

Pola
ad_user_data

ConsentStatus

Opcjonalnie. Określa, czy użytkownik wyraża zgodę na korzystanie z danych użytkowników reklam.
ad_personalization

ConsentStatus

Opcjonalnie. Określa, czy użytkownik wyraża zgodę na personalizację reklam.

ConsentStatus

Wskazuje, czy użytkownik wyraził zgodę, odmówił jej udzielenia czy nie określił swojego stanowiska.

Wartości w polu enum
CONSENT_STATUS_UNSPECIFIED Nie określono.
CONSENT_GRANTED Przyznano.
CONSENT_DENIED Odrzucono.

ContactIdInfo

Dodatkowe informacje, gdy CONTACT_ID jest jednym z upload_key_types.

Pola
match_rate_percentage

int32

Tylko dane wyjściowe. Współczynnik dopasowania list użytkowników kierowania na listę klientów.
data_source_type

DataSourceType

Opcjonalnie. Niezmienne. Źródło przesyłanych danych

CreatePartnerLinkRequest

Prośba o utworzenie zasobu PartnerLink. Zwraca wartość PartnerLink.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
parent

string

Wymagane. Element nadrzędny, do którego należy ta kolekcja linków partnerskich. Format: accountTypes/{account_type}/accounts/{account}

CreateUserListDirectLicenseRequest

Prośba o utworzenie zasobu UserListDirectLicense.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
parent

string

Wymagane. Konto, do którego należy licencjonowana lista użytkowników. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
user_list_direct_license

UserListDirectLicense

Wymagane. Lista użytkowników z bezpośrednią licencją do utworzenia.

CreateUserListGlobalLicenseRequest

Prośba o utworzenie zasobu UserListGlobalLicense.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
parent

string

Wymagane. Konto, do którego należy licencjonowana lista użytkowników. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
user_list_global_license

UserListGlobalLicense

Wymagane. Globalna licencja na listę użytkowników do utworzenia.

CreateUserListRequest

Wiadomość z prośbą o utworzenie listy użytkowników.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
parent

string

Wymagane. Konto nadrzędne, na którym zostanie utworzona ta lista użytkowników. Format: accountTypes/{account_type}/accounts/{account}
user_list

UserList

Wymagane. Lista użytkowników do utworzenia.
validate_only

bool

Opcjonalnie. Jeśli wartość to prawda, żądanie jest weryfikowane, ale nie wykonywane.

Zmienna niestandardowa

Zmienna niestandardowa na potrzeby konwersji z reklam.

Pola
variable

string

Opcjonalnie. Nazwa zmiennej niestandardowej do ustawienia. Jeśli zmienna nie zostanie znaleziona w przypadku danego miejsca docelowego, zostanie zignorowana.
value

string

Opcjonalnie. Wartość do zapisania w zmiennej niestandardowej.
destination_references[]

string

Opcjonalnie. Ciąg odniesienia używany do określania, do którego z Event.destination_references należy wysłać zmienną niestandardową. Jeśli pole jest puste, używana jest wartość Event.destination_references.

CustomerType

Typ klienta powiązanego ze zdarzeniem.

Wartości w polu enum
CUSTOMER_TYPE_UNSPECIFIED Nieokreślony typ klienta. Nigdy nie należy go używać.
NEW klient jest nowy dla reklamodawcy.
RETURNING Klient wraca do reklamodawcy.
REENGAGED Klient ponownie zaangażował się w interakcję z reklamodawcą.

CustomerValueBucket

Wartość klienta określona przez reklamodawcę.

Wartości w polu enum
CUSTOMER_VALUE_BUCKET_UNSPECIFIED Unspecified CustomerValueBucket. Nigdy nie należy go używać.
LOW Klient ma niską wartość.
MEDIUM Klient ma średnią wartość.
HIGH Klient jest wartościowy.

DataSourceType

Wskazuje źródło danych przesyłanych do Google Ads.

Wartości w polu enum
DATA_SOURCE_TYPE_UNSPECIFIED Nie określono.
DATA_SOURCE_TYPE_FIRST_PARTY Przesłane dane to dane własne.
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU Przesłane dane pochodzą z zewnętrznego biura informacji kredytowej.
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE Przesłane dane pochodzą z pliku wyborców innej firmy.
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA Przesłane dane to dane partnera zewnętrznego.

DeletePartnerLinkRequest

Prośba o usunięcie zasobu PartnerLink. Zwraca wartość google.protobuf.Empty.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
name

string

Wymagane. Nazwa zasobu linku partnera do usunięcia. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

DeleteUserListRequest

Komunikat żądania dla funkcji DeleteUserList.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
name

string

Wymagane. Nazwa listy użytkowników do usunięcia. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
validate_only

bool

Opcjonalnie. Jeśli wartość to prawda, żądanie jest weryfikowane, ale nie wykonywane.

Miejsce docelowe

Usługa Google, do której wysyłasz dane. Na przykład konto Google Ads.

Pola
reference

string

Opcjonalnie. Identyfikator tego zasobu Destination, unikalny w ramach żądania. Użyj tego, aby odwołać się do tego elementu Destination w elementach IngestEventsRequest i IngestAudienceMembersRequest.
login_account

ProductAccount

Opcjonalnie. Konto użyte do wykonania tego wywołania interfejsu API. Aby dodawać lub usuwać dane z operating_account, to urządzenie login_account musi mieć uprawnienia do zapisu w operating_account. Na przykład konto menedżera operating_account lub konto z ustalonym połączeniem z operating_account.
linked_account

ProductAccount

Opcjonalnie. Konto, do którego login_account użytkownika wywołującego ma dostęp za pomocą utworzonego połączenia kont. Na przykład login_account partnera danych może mieć dostęp do linked_account klienta. Partner może używać tego pola do wysyłania danych z linked_account do innego operating_account.
operating_account

ProductAccount

Wymagane. Konto, na które mają być wysyłane dane lub z którego mają być usuwane.
product_destination_id

string

Wymagane. Obiekt na koncie usługi, do którego mają być przesyłane dane. Może to być np. identyfikator listy odbiorców Google Ads, identyfikator listy odbiorców Display & Video 360 lub identyfikator działania powodującego konwersję w Google Ads.

DeviceInfo

Informacje o urządzeniu używanym (jeśli dotyczy) w momencie wystąpienia zdarzenia.

Pola
user_agent

string

Opcjonalnie. Ciąg znaków klienta użytkownika urządzenia w danym kontekście.
ip_address

string

Opcjonalnie. Adres IP urządzenia w danym kontekście.

Uwaga: Google Ads nie obsługuje dopasowywania adresów IP w przypadku użytkowników z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii (UK) i Szwajcarii (CH). Dodaj funkcję logiczną, która warunkowo wyklucza udostępnianie adresów IP użytkowników z tych regionów, i zadbaj o to, aby udostępniać użytkownikom jasne i wyczerpujące informacje na temat danych, które zbierasz w swoich witrynach, aplikacjach i innych usługach, a jeśli jest to wymagane przez prawo lub obowiązujące zasady Google, uzyskać ich zgodę. Więcej informacji znajdziesz na stronie Importowanie konwersji offline.
category

string

Opcjonalnie. Kategoria urządzenia. Na przykład „komputer”, „tablet”, „komórka”, „telewizor smart TV”.
language_code

string

Opcjonalnie. Język używany przez urządzenie w formacie ISO 639-1.
screen_height

int32

Opcjonalnie. Wysokość ekranu w pikselach.
screen_width

int32

Opcjonalnie. Szerokość ekranu w pikselach.
operating_system

string

Opcjonalnie. System operacyjny lub platforma urządzenia.
operating_system_version

string

Opcjonalnie. Wersja systemu operacyjnego lub platformy.
model

string

Opcjonalnie. Model urządzenia.
brand

string

Opcjonalnie. Marka urządzenia.
browser

string

Opcjonalnie. Marka lub typ przeglądarki.
browser_version

string

Opcjonalnie. Wersja przeglądarki.

Kodowanie

Typ kodowania zahaszowanych informacji umożliwiających identyfikację.

Wartości w polu enum
ENCODING_UNSPECIFIED Nieokreślony typ kodowania. Nigdy nie należy go używać.
HEX Kodowanie szesnastkowe.
BASE64 kodowanie Base64.

EncryptedUserId

Identyfikator użytkownika wydany do celów atrybucji. Jeśli używasz tego parametru, wszystkie pola są wymagane.

Pola
encrypted_id

string

Wymagane. Alfanumeryczny zaszyfrowany identyfikator.
entity_type

EncryptionEntityType

Wymagane. Typ jednostki szyfrowania. Powinno to być zgodne z konfiguracją szyfrowania na potrzeby wyświetlania reklam lub przenoszenia danych.
entity_id

int64

Wymagane. Identyfikator jednostki szyfrowania. Powinno to być zgodne z konfiguracją szyfrowania na potrzeby wyświetlania reklam lub przenoszenia danych.
source

EncryptionSource

Wymagane. Określa, czy zaszyfrowany plik cookie został otrzymany z wyświetlania reklam (makro %m) czy z przenoszenia danych.

EncryptionEntityType

Typ jednostki szyfrowania.

Wartości w polu enum
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED Nieokreślony typ elementu szyfrowania.
CAMPAIGN_MANAGER_ACCOUNT konto w usłudze Campaign Manager 360;
CAMPAIGN_MANAGER_ADVERTISER reklamodawcą w usłudze Campaign Manager 360.
DISPLAY_VIDEO_PARTNER partnera Display & Video 360.
DISPLAY_VIDEO_ADVERTISER reklamodawcą Display & Video 360;
GOOGLE_ADS_CUSTOMER klient Google Ads;
GOOGLE_AD_MANAGER_NETWORK_CODE Kod sieci Google Ad Managera.

EncryptionSource

Źródło szyfrowania.

Wartości w polu enum
ENCRYPTION_SOURCE_UNSPECIFIED Nieokreślone źródło szyfrowania.
AD_SERVING Źródło szyfrowania wyświetlania reklam.
DATA_TRANSFER Źródło szyfrowania przesyłania danych.

EncryptionInfo

Informacje o szyfrowaniu przesyłanych danych.

Pola
Pole zbiorcze wrapped_key. Klucz opakowany użyty do zaszyfrowania danych. wrapped_key może mieć tylko jedną z tych wartości:
gcp_wrapped_key_info

GcpWrappedKeyInfo

Informacje o kluczu obudowanym w Google Cloud Platform.
aws_wrapped_key_info

AwsWrappedKeyInfo

Informacje o kluczu obudowanym przez Amazon Web Services.

ErrorCount

Liczba błędów dla danej przyczyny błędu.

Pola
record_count

int64

Liczba rekordów, których nie udało się przesłać z określonego powodu.
reason

ProcessingErrorReason

Przyczyna błędu w przypadku nieudanych rekordów.

ErrorInfo

Liczba błędów każdego typu.

Pola
error_counts[]

ErrorCount

Lista błędów i liczba błędów według przyczyny. W niektórych przypadkach może nie być wypełniona.

ErrorReason

Przyczyny błędów interfejsu Data Manager API. UWAGA: ta wyliczeniowa lista stałych nie jest zamrożona i w przyszłości mogą zostać do niej dodane nowe wartości.

Wartości w polu enum
ERROR_REASON_UNSPECIFIED Nie używaj tej wartości domyślnej.
INTERNAL_ERROR Wystąpił błąd wewnętrzny.
DEADLINE_EXCEEDED Odpowiedź na żądanie zajęła zbyt dużo czasu.
RESOURCE_EXHAUSTED Zbyt wiele żądań.
NOT_FOUND Nie znaleziono zasobu.
PERMISSION_DENIED Użytkownik nie ma uprawnień lub zasób nie został znaleziony.
INVALID_ARGUMENT Wystąpił problem z żądaniem.
REQUIRED_FIELD_MISSING Wymagane pole jest puste.
INVALID_FORMAT Format jest nieprawidłowy.
INVALID_HEX_ENCODING Wartość zakodowana w formacie szesnastkowym jest nieprawidłowa.
INVALID_BASE64_ENCODING Wartość zakodowana w formacie base64 jest nieprawidłowa.
INVALID_SHA256_FORMAT Wartość zakodowana za pomocą algorytmu SHA256 jest nieprawidłowa.
INVALID_POSTAL_CODE Kod pocztowy jest nieprawidłowy.
INVALID_COUNTRY_CODE

Wycofano: wyliczenie nie jest używane w interfejsie Data Manager API.
INVALID_ENUM_VALUE Nie można użyć wartości typu wyliczeniowego.
INVALID_USER_LIST_TYPE Typ listy użytkowników nie ma zastosowania do tego żądania.
INVALID_AUDIENCE_MEMBER Ten odbiorca jest nieprawidłowy.
TOO_MANY_AUDIENCE_MEMBERS Maksymalna dozwolona liczba członków listy odbiorców na żądanie to 10 000.
TOO_MANY_USER_IDENTIFIERS Maksymalna dozwolona liczba identyfikatorów użytkownika na członka listy odbiorców to 10.
TOO_MANY_DESTINATIONS Maksymalna liczba miejsc docelowych dozwolonych w przypadku jednego żądania to 10.
INVALID_DESTINATION To miejsce docelowe jest nieprawidłowe.
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED Partner danych nie ma dostępu do listy użytkowników należącej do konta operacyjnego.
INVALID_MOBILE_ID_FORMAT Format identyfikatora urządzenia mobilnego jest nieprawidłowy.
INVALID_USER_LIST_ID Lista użytkowników jest nieprawidłowa.
MULTIPLE_DATA_TYPES_NOT_ALLOWED W jednym żądaniu nie można przesyłać danych wielu typów.
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER Konfiguracje miejsc docelowych zawierające konto logowania DataPartner muszą mieć to samo konto logowania we wszystkich konfiguracjach miejsc docelowych.
TERMS_AND_CONDITIONS_NOT_SIGNED Wymagane warunki nie zostały zaakceptowane.
INVALID_NUMBER_FORMAT Nieprawidłowy format liczby.
INVALID_CONVERSION_ACTION_ID Identyfikator działania powodującego konwersję jest nieprawidłowy.
INVALID_CONVERSION_ACTION_TYPE Typ działania powodującego konwersję jest nieprawidłowy.
INVALID_CURRENCY_CODE Kod waluty nie jest obsługiwany.
INVALID_EVENT To wydarzenie jest nieprawidłowe.
TOO_MANY_EVENTS Maksymalna dozwolona liczba zdarzeń na żądanie to 10 000.
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Na koncie docelowym nie są włączone konwersje rozszerzone dotyczące potencjalnych klientów.
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS Na koncie docelowym nie można korzystać z konwersji rozszerzonych ze względu na zasady Google dotyczące danych klientów. Skontaktuj się z przedstawicielem Google.
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Konto docelowe nie zaakceptowało warunków dotyczących konwersji rozszerzonych.
DUPLICATE_DESTINATION_REFERENCE Co najmniej 2 miejsca docelowe w żądaniu mają to samo odwołanie.
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER Nieobsługiwane konto operacyjne do autoryzacji dostawcy danych.
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER Nieobsługiwane połączone konto do autoryzacji dostawcy danych.
NO_IDENTIFIERS_PROVIDED Dane zdarzeń nie zawierają identyfikatorów użytkowników ani identyfikatorów reklam. W przypadku pozyskiwania zdarzeń Floodlight ten błąd oznacza, że żądania nie zawierają identyfikatorów reklam.
INVALID_PROPERTY_TYPE Ten typ usługi nie jest obsługiwany.
INVALID_STREAM_TYPE Ten typ strumienia nie jest obsługiwany.
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT Połączone konto jest obsługiwane tylko wtedy, gdy konto logowania jest kontem DATA_PARTNER.
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH Konto logowania musi być takie samo jak konto operacyjne w danym przypadku użycia.
EVENT_TIME_INVALID Zdarzenie nie wystąpiło w dopuszczalnym przedziale czasu.
RESERVED_NAME_USED Parametr używa zarezerwowanej nazwy.
INVALID_EVENT_NAME Nazwa zdarzenia nie jest obsługiwana.
NOT_ALLOWLISTED Konto nie znajduje się na liście dozwolonych w przypadku tej funkcji.
INVALID_REQUEST_ID Identyfikator żądania użyty do pobrania stanu żądania jest nieprawidłowy. Stan można pobrać tylko w przypadku żądań, które zostały zrealizowane i nie mają wartości validate_only=true.
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT Zdarzenie miało co najmniej 2 usługi docelowe Google Analytics.
FIELD_VALUE_TOO_LONG Wartość pola jest za długa.
FIELD_VALUE_TOO_SHORT Wartość pola jest zbyt krótka.
TOO_MANY_ELEMENTS Żądanie zawiera zbyt wiele elementów na liście.
TOO_FEW_ELEMENTS Żądanie zawiera zbyt mało elementów na liście.
ALREADY_EXISTS Zasób już istnieje.
IMMUTABLE_FIELD_FOR_UPDATE Podjęto próbę ustawienia niezmiennego pola w prośbie o aktualizację.
INVALID_RESOURCE_NAME Nazwa zasobu jest nieprawidłowa.
INVALID_FILTER Filtr zapytania jest nieprawidłowy.
INVALID_UPDATE_MASK Maska aktualizacji jest nieprawidłowa.
INVALID_PAGE_TOKEN Token strony jest nieprawidłowy.
CANNOT_UPDATE_DISABLED_LICENSE Nie można zaktualizować wyłączonej licencji.
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST Nie można licencjonować wrażliwych list użytkowników na rzecz tego klienta.
INSUFFICIENT_COST Koszt jest zbyt niski w przypadku tej licencji.
CANNOT_DISABLE_LICENSE Nie można wyłączyć licencji sprzedawcy, ponieważ jest ona używana.
INVALID_CLIENT_ACCOUNT_ID Nieprawidłowy identyfikator konta klienta.
PRICING_ONLY_ZERO_COST_ALLOWED Na tym koncie klienta nie można ustawić kosztu różnego od zera.
PRICE_TOO_HIGH Koszt jest zbyt wysoki w przypadku tej licencji.
CUSTOMER_NOT_ALLOWED_TO_CREATE_LICENSE Klient nie ma uprawnień do utworzenia licencji.
INVALID_PRICING_END_DATE Data zakończenia ceny jest nieprawidłowa w przypadku tej licencji.
CANNOT_LICENSE_LOGICAL_LIST_WITH_LICENSED_OR_SHARED_SEGMENT Logicznej listy użytkowników z udostępnianym lub licencjonowanym segmentem nie można licencjonować.
MISMATCHED_ACCOUNT_TYPE Typ konta klienta w żądaniu nie pasuje do rzeczywistego typu konta klienta.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_LICENSE_TYPE Typ licencji nie obsługuje kosztu udostępniania multimediów.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_CLIENT_CUSTOMER Typ klienta nie obsługuje kosztu udziału w mediach.
INVALID_MEDIA_SHARE_COST Nieprawidłowy koszt udziału w mediach.
INVALID_COST_TYPE Nieprawidłowy typ kosztu.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_NON_COMMERCE_USER_LIST Typ UserList nie obsługuje kosztu udostępniania multimediów.
MAX_COST_NOT_ALLOWED Maksymalny koszt jest dozwolony tylko w przypadku wartości cost_type MEDIA_SHARE.
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED Listy odbiorców handlowych można licencjonować tylko bezpośrednio.
INVALID_DESCRIPTION Opis jest nieprawidłowy.
INVALID_DISPLAY_NAME Wyświetlana nazwa jest nieprawidłowa.
DISPLAY_NAME_ALREADY_USED Wyświetlana nazwa jest już używana na liście użytkowników na tym koncie.
OWNERSHIP_REQUIRED_FOR_UPDATE Aby zmodyfikować listę użytkowników, musisz być właścicielem.
USER_LIST_MUTATION_NOT_SUPPORTED Typ listy użytkowników jest tylko do odczytu i nie obsługuje mutacji.
SENSITIVE_USER_LIST_IMMUTABLE Listy odbiorców, które zawierają dane wymagające ochrony prywatności lub zostały odrzucone ze względów prawnych, nie mogą być modyfikowane przez użytkowników zewnętrznych.
BILLABLE_RECORD_COUNT_IMMUTABLE Po ustawieniu pola rekordu podlegającego rozliczeniu na liście użytkowników remarketingu nie można go zmienić.
USER_LIST_NAME_RESERVED Nazwa listy użytkowników jest zarezerwowana dla list systemowych.
ADVERTISER_NOT_ALLOWLISTED_FOR_UPLOADED_DATA Aby korzystać z list remarketingowych utworzonych na podstawie danych przesłanych przez reklamodawcę, musi on zostać dodany do listy dozwolonych.
UNSUPPORTED_PARTNER_AUDIENCE_SOURCE Źródło odbiorców partnera nie jest obsługiwane w przypadku tego typu listy użytkowników.
COMMERCE_PARTNER_NOT_ALLOWED Ustawienie pola commerce_partner jest obsługiwane tylko wtedy, gdy pole partner_audience_source ma wartość COMMERCE_AUDIENCE.
UNSUPPORTED_PARTNER_AUDIENCE_INFO Pole partner_audience_info nie jest obsługiwane w przypadku typu listy użytkowników.
PARTNER_MATCH_FOR_MANAGER_ACCOUNT_DISALLOWED Listy użytkowników Dopasowywania partnerów nie można tworzyć na kontach menedżera.
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA Dostawca danych nie jest na liście dozwolonych dla danych partnera zewnętrznego.
ADVERTISER_TOS_NOT_ACCEPTED Reklamodawca nie zaakceptował warunków korzystania z usługi partnera.
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA Reklamodawca nie jest na liście dozwolonych dla danych partnerów zewnętrznych.
USER_LIST_TYPE_NOT_SUPPORTED_FOR_ACCOUNT Ten typ listy użytkowników nie jest obsługiwany na tym koncie.
INVALID_COMMERCE_PARTNER Pole commerce_partner jest nieprawidłowe.
CUSTOMER_NOT_ALLOWLISTED_FOR_COMMERCE_AUDIENCE Dostawca danych nie ma uprawnień do tworzenia list odbiorców z branży handlowej.
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES Typy kluczy przesyłania list użytkowników nie są obsługiwane.
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG Konfiguracja informacji o zaimportowanej liście użytkowników jest nieobsługiwana.
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE Te typy kont nie są obsługiwane w przypadku tego typu listy użytkowników.
MEMBERSHIP_DURATION_TOO_LONG Okres członkostwa na liście użytkowników jest za długi.
INVALID_MERCHANT_ID Pole merchant_id jest nieprawidłowe.
EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED Klient ma kampanie, które nie są zwolnione z obowiązku składania deklaracji dotyczącej reklam politycznych w UE.
ACCOUNT_INELIGIBLE_FOR_STORE_SALES Konto nie kwalifikuje się do korzystania z pomiaru sprzedaży w sklepie.
INVALID_MERCHANT_FEED_LANGUAGE_CODE Kod języka pliku danych sprzedawcy jest nieprawidłowy.
INVALID_REGION_CODE Kod regionu jest nieprawidłowy.
INVALID_SUBDIVISION_CODE Kod podziału administracyjnego jest nieprawidłowy.
INVALID_SUBCONTINENT_CODE Kod subkontynentu jest nieprawidłowy.
INVALID_CONTINENT_CODE Kod kontynentu jest nieprawidłowy.
INVALID_DEVICE_CATEGORY Kategoria urządzenia jest nieprawidłowa.
BOTH_CLIENT_ID_AND_APP_INSTANCE_ID_NOT_ALLOWED Ustawione są zarówno app_instance_id, jak i client_id.
GOOGLE_ANALYTICS_SUBPROPERTY_OR_ROLLUP_PROPERTY_NOT_ALLOWED Usługa w Google Analytics jest usługą podrzędną lub usługą o pełnym zakresie.
THIRD_PARTY_USER_DATA_NOT_ALLOWED Dane użytkowników pochodzące od osób trzecich mogą być ustawiane tylko przez partnerów danych.
INVALID_COUPON_CODE Kod kuponu jest nieprawidłowy.
EVENT_SOURCE_AND_DESTINATION_MISMATCH Typ źródła zdarzenia nie pasuje do typu miejsca docelowego.
DESTINATION_ACCOUNT_TYPE_MISMATCH Typ konta docelowego nie pasuje do podanego identyfikatora konta.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII Wartość zmiennej niestandardowej zawiera informacje umożliwiające identyfikację.
CUSTOM_VARIABLE_NOT_ENABLED Zmienna niestandardowa nie jest włączona.
INVALID_CUSTOM_VARIABLE_VALUE Wartość zmiennej niestandardowej jest nieprawidłowa.
CUSTOM_VARIABLE_NOT_FOUND Miejsce docelowe nie ma zmiennej niestandardowej o nazwie zgodnej z określonym wzorcem variable.
BASELINE_LOCATION_AUTO_DETECTION_FAILED Pole location_auto_detection_enabled w żądaniu miało wartość true, ale automatyczne wykrywanie lokalizacji podstawowej nie powiodło się.
INSIGHTS_MISSING_FOR_DIMENSION Brak statystyk dotyczących tego wymiaru.

Zdarzenie

Zdarzenie reprezentujące interakcję użytkownika z witryną lub aplikacją reklamodawcy.

Pola
destination_references[]

string

Opcjonalnie. Ciąg referencyjny używany do określania miejsca docelowego. Jeśli to pole jest puste, zdarzenie zostanie wysłane do wszystkich destinations w żądaniu.
transaction_id

string

Opcjonalnie. Unikalny identyfikator tego zdarzenia. Wymagane w przypadku zdarzeń wysyłanych jako dodatkowe źródło danych na potrzeby konwersji rejestrowanych przez tag.
event_timestamp

Timestamp

Wymagane. Czas wystąpienia zdarzenia.
last_updated_timestamp

Timestamp

Opcjonalnie. Ostatnia aktualizacja wydarzenia.
user_data

UserData

Opcjonalnie. Fragmenty danych przekazywanych przez użytkowników, które reprezentują użytkownika powiązanego ze zdarzeniem.
consent

Consent

Opcjonalnie. Informacje o tym, czy powiązany użytkownik wyraził zgodę na różne rodzaje przetwarzania danych.
ad_identifiers

AdIdentifiers

Opcjonalnie. Identyfikatory i inne informacje używane do dopasowywania zdarzenia konwersji do innej aktywności online (np. kliknięć reklam).
currency

string

Opcjonalnie. Kod waluty powiązany ze wszystkimi wartościami pieniężnymi w tym zdarzeniu.
event_source

EventSource

Opcjonalnie. Sygnał wskazujący, gdzie wystąpiło zdarzenie (w internecie, w aplikacji, w sklepie stacjonarnym itp.).
event_device_info

DeviceInfo

Opcjonalnie. Informacje zebrane o używanym urządzeniu (jeśli takie było) w momencie wystąpienia zdarzenia.
cart_data

CartData

Opcjonalnie. Informacje o transakcji i produktach powiązanych ze zdarzeniem.
custom_variables[]

CustomVariable

Opcjonalnie. Dodatkowe informacje o parach klucz/wartość do wysłania do kontenerów konwersji (działanie powodujące konwersję lub aktywność FL).
experimental_fields[]

ExperimentalField

Opcjonalnie. Lista par klucz/wartość dla pól eksperymentalnych, które mogą ostatecznie zostać włączone do interfejsu API.
user_properties

UserProperties

Opcjonalnie. Informacje o użytkowniku ocenione przez reklamodawcę w momencie wystąpienia zdarzenia.
event_name

string

Opcjonalnie. Nazwa zdarzenia. Wymagany w przypadku zdarzeń GA4.
client_id

string

Opcjonalnie. Unikalny identyfikator instancji użytkownika klienta internetowego w tym strumieniu danych z sieci GA4.
user_id

string

Opcjonalnie. Unikalny identyfikator użytkownika zdefiniowany przez reklamodawcę.
additional_event_parameters[]

EventParameter

Opcjonalnie. Zbiór dowolnych parametrów zdarzenia, które mają być uwzględnione w zdarzeniu, a nie zostały jeszcze określone za pomocą innych pól strukturalnych.
third_party_user_data

UserData

Opcjonalnie. Ten sam typ danych, który jest podawany w parametrze user_data, ale wyraźnie oznaczony jako dane należące do firmy zewnętrznej, a nie do reklamodawcy oferującego własne usługi.
event_location

EventLocation

Opcjonalnie. Informacje zebrane o lokalizacji użytkownika w momencie wystąpienia tego zdarzenia.
app_instance_id

string

Opcjonalnie. Unikalny identyfikator instancji użytkownika aplikacji klienta w tym strumieniu danych aplikacji w GA4.
conversion_value

double

Opcjonalnie. Wartość konwersji powiązana ze zdarzeniem w przypadku konwersji opartych na wartości.
conversion_count

double

Opcjonalnie. Ilość konwersji powiązana ze zdarzeniem w przypadku konwersji opartych na zliczaniu.

EventLocation

Lokalizacja, w której wystąpiło zdarzenie.

Pola
store_id

string

Opcjonalnie. Wymagane w przypadku sprzedaży w sklepie. Identyfikator reprezentujący sklep stacjonarny, w którym wystąpiło zdarzenie.
city

string

Opcjonalnie. Nazwa miasta, w którym wystąpiło zdarzenie.
subdivision_code

string

Opcjonalnie. Kod podziału administracyjnego zgodny ze standardem ISO 3166-2, w którym wystąpiło zdarzenie.
region_code

string

Opcjonalnie. 2-literowy kod regionu CLDR adresu użytkownika.
subcontinent_code

string

Opcjonalnie. Kod subkontynentu w formacie UN M49, na którym wystąpiło zdarzenie.
continent_code

string

Opcjonalnie. Kod kontynentu w formacie UN M49, na którym wystąpiło zdarzenie.

EventParameter

Parametr zdarzenia w przypadku zdarzeń GA4.

Pola
parameter_name

string

Wymagane. Nazwa parametru do użycia.
value

string

Wymagane. Ciąg znaków reprezentujący wartość parametru do ustawienia.

EventSource

Źródło zdarzenia.

Wartości w polu enum
EVENT_SOURCE_UNSPECIFIED Nieokreślone źródło zdarzeń. Nigdy nie należy go używać.
WEB Wydarzenie zostało wygenerowane w przeglądarce.
APP Wydarzenie zostało wygenerowane przez aplikację.
IN_STORE Wydarzenie zostało wygenerowane na podstawie transakcji w sklepie stacjonarnym.
PHONE Wydarzenie zostało wygenerowane na podstawie rozmowy telefonicznej.
MESSAGE Wydarzenie zostało wygenerowane na podstawie wiadomości.
OTHER Wydarzenie zostało wygenerowane z innych źródeł.

ExperimentalField

Eksperymentalne pole reprezentujące nieoficjalne pola.

Pola
field

string

Opcjonalnie. Nazwa pola do użycia.
value

string

Opcjonalnie. Wartość pola do ustawienia.

GcpWrappedKeyInfo

Informacje o kluczu opakowanym Google Cloud Platform.

Pola
key_type

KeyType

Wymagane. Typ algorytmu użytego do zaszyfrowania danych.
wip_provider

string

Wymagane. Dostawca puli Workload Identity wymagany do używania klucza KEK.
kek_uri

string

Wymagane. Identyfikator zasobu Cloud Key Management Service w Google Cloud Platform. Powinien mieć format projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} lub gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}
encrypted_dek

string

Wymagane. Zaszyfrowany klucz szyfrujący dane zakodowany w formacie base64.

KeyType

Typ algorytmu użytego do zaszyfrowania danych.

Wartości w polu enum
KEY_TYPE_UNSPECIFIED Nieokreślony typ klucza. Nigdy nie należy go używać.
XCHACHA20_POLY1305 Algorytm XChaCha20-Poly1305

Płeć

Rodzaj płci (np. kobieta).

Wartości w polu enum
GENDER_UNSPECIFIED Nie określono.
GENDER_UNKNOWN Brak informacji.
GENDER_MALE Mężczyzna.
GENDER_FEMALE Damskie.

GetUserListDirectLicenseRequest

Prośba o pobranie zasobu UserListDirectLicense.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
name

string

Wymagane. Nazwa zasobu licencji bezpośredniej listy użytkowników.

GetUserListGlobalLicenseRequest

Prośba o pobranie zasobu UserListGlobalLicense.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
name

string

Wymagane. Nazwa zasobu globalnej licencji na listę użytkowników.

GetUserListRequest

Wiadomość z prośbą o wywołanie GetUserList.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
name

string

Wymagane. Nazwa zasobu listy użytkowników do pobrania. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

IngestAudienceMembersRequest

Prośba o przesłanie członków grupy odbiorców do podanych miejsc docelowych. Zwraca wartość IngestAudienceMembersResponse.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
destinations[]

Destination

Wymagane. Lista miejsc docelowych, do których mają być wysyłani odbiorcy.
audience_members[]

AudienceMember

Wymagane. Lista użytkowników, do których mają być wysyłane dane do określonych miejsc docelowych. W jednym żądaniu można wysłać maksymalnie 10 tys. AudienceMember zasobów.
consent

Consent

Opcjonalnie. Zgoda na poziomie żądania, która ma być stosowana do wszystkich użytkowników w żądaniu. Zgoda na poziomie użytkownika zastępuje zgodę na poziomie żądania i może być określona w każdym AudienceMember.
validate_only

bool

Opcjonalnie. Do celów testowych. Jeśli true, żądanie jest weryfikowane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki.
encoding

Encoding

Opcjonalnie. Wymagane w przypadku przesyłania plików UserData. Typ kodowania identyfikatorów użytkowników. W przypadku zaszyfrowanych identyfikatorów użytkowników jest to typ kodowania zaszyfrowanego ciągu znaków. W przypadku zaszyfrowanych, zahaszowanych identyfikatorów użytkowników jest to typ kodowania zewnętrznego zaszyfrowanego ciągu znaków, ale niekoniecznie wewnętrznego zahaszowanego ciągu znaków. Oznacza to, że wewnętrzny zahaszowany ciąg znaków może być zakodowany w inny sposób niż zewnętrzny zaszyfrowany ciąg znaków. W przypadku przesyłania plików innych niż UserData to pole jest ignorowane.
encryption_info

EncryptionInfo

Opcjonalnie. Informacje o szyfrowaniu przesyłanych plików w UserData. Jeśli nie jest ustawiona, zakłada się, że przesłane informacje umożliwiające identyfikację są zahaszowane, ale nie zaszyfrowane. W przypadku przesyłania plików innych niż UserData to pole jest ignorowane.
terms_of_service

TermsOfService

Opcjonalnie. Warunki korzystania z usługi, które użytkownik zaakceptował lub odrzucił.

IngestAudienceMembersResponse

Odpowiedź z IngestAudienceMembersRequest.

Pola
request_id

string

Automatycznie wygenerowany identyfikator żądania.

IngestEventsRequest

Prośba o przesłanie członków grupy odbiorców do podanych miejsc docelowych. Zwraca wartość IngestEventsResponse.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
destinations[]

Destination

Wymagane. Lista miejsc docelowych, do których mają być wysyłane zdarzenia.
events[]

Event

Wymagane. Lista zdarzeń do wysłania do określonych miejsc docelowych. W jednym żądaniu można wysłać maksymalnie 2000 zasobów Event.
consent

Consent

Opcjonalnie. Zgoda na poziomie żądania, która ma być stosowana do wszystkich użytkowników w żądaniu. Zgoda na poziomie użytkownika zastępuje zgodę na poziomie żądania i może być określona w każdym Event.
validate_only

bool

Opcjonalnie. Do celów testowych. Jeśli true, żądanie jest weryfikowane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki.
encoding

Encoding

Opcjonalnie. Wymagane w przypadku przesyłania plików UserData. Typ kodowania identyfikatorów użytkowników. W przypadku zaszyfrowanych identyfikatorów użytkowników jest to typ kodowania zaszyfrowanego ciągu znaków. W przypadku zaszyfrowanych, zahaszowanych identyfikatorów użytkowników jest to typ kodowania zewnętrznego zaszyfrowanego ciągu znaków, ale niekoniecznie wewnętrznego zahaszowanego ciągu znaków. Oznacza to, że wewnętrzny zahaszowany ciąg znaków może być zakodowany w inny sposób niż zewnętrzny zaszyfrowany ciąg znaków. W przypadku przesyłania plików innych niż UserData to pole jest ignorowane.
encryption_info

EncryptionInfo

Opcjonalnie. Informacje o szyfrowaniu przesyłanych plików w UserData. Jeśli nie jest ustawiona, zakłada się, że przesłane informacje umożliwiające identyfikację są zahaszowane, ale nie zaszyfrowane. W przypadku przesyłania plików innych niż UserData to pole jest ignorowane.

IngestEventsResponse

Odpowiedź z IngestEventsRequest.

Pola
request_id

string

Automatycznie wygenerowany identyfikator żądania.

IngestedUserListInfo

Reprezentuje listę użytkowników wypełnioną danymi przekazanymi przez użytkowników.

Pola
upload_key_types[]

UploadKeyType

Wymagane. Niezmienne. Typy kluczy przesyłania tej listy użytkowników.
contact_id_info

ContactIdInfo

Opcjonalnie. Dodatkowe informacje, gdy CONTACT_ID jest jednym z upload_key_types.
mobile_id_info

MobileIdInfo

Opcjonalnie. Dodatkowe informacje, gdy MOBILE_ID jest jednym z upload_key_types.
user_id_info

UserIdInfo

Opcjonalnie. Dodatkowe informacje, gdy USER_ID jest jednym z upload_key_types.
pair_id_info

PairIdInfo

Opcjonalnie. Dodatkowe informacje, gdy PAIR_ID jest jednym z upload_key_types.

Ta funkcja jest dostępna tylko dla partnerów danych.
pseudonymous_id_info

PseudonymousIdInfo

Opcjonalnie. Dodatkowe informacje o PSEUDONYMOUS_ID to jeden z upload_key_types.
partner_audience_info

PartnerAudienceInfo

Opcjonalnie. Dodatkowe informacje o odbiorcach partnerów.

Ta funkcja jest dostępna tylko dla partnerów danych.

UploadKeyType

Enum zawierający możliwe typy kluczy przesyłania listy użytkowników.

Wartości w polu enum
UPLOAD_KEY_TYPE_UNSPECIFIED Nie określono.
CONTACT_ID informacje o klientach, takie jak adres e-mail, numer telefonu lub adres pocztowy;
MOBILE_ID Identyfikatory wyświetlania reklam mobilnych.
USER_ID Identyfikatory użytkowników dostarczone przez osoby trzecie.
PAIR_ID Identyfikatory dopasowywania danych o tożsamości użytkowników.
PSEUDONYMOUS_ID Identyfikatory platformy zarządzania danymi: - Identyfikator użytkownika Google - Identyfikator dostarczony przez partnera - Identyfikator dostarczony przez wydawcę - Identyfikator IDFA w iOS - Identyfikator wyświetlania reklam w Androidzie - Identyfikator Roku - Identyfikator Amazon Fire TV - Identyfikator Xbox lub Microsoft

IpData

Informacje o adresie IP użytkownika. Aby zwiększyć współczynniki dopasowania w przypadku kierowania na listę klientów, zalecamy uwzględnienie parametrów observe_start_time i observe_end_time.

Pola
ip_address

string

Wymagane. Adres IP zarejestrowany w momencie interakcji z klientem. Akceptuje standardowe formaty ciągów znaków zarówno w przypadku protokołu IPv4, jak i IPv6.
observe_start_time

Timestamp

Opcjonalnie. Czas pierwszej zarejestrowanej interakcji z tego adresu IP w ramach sesji.
observe_end_time

Timestamp

Opcjonalnie. Czas ostatniej zarejestrowanej interakcji z tego adresu IP w ramach sesji.

Element

Reprezentuje produkt w koszyku powiązany ze zdarzeniem.

Pola
merchant_product_id

string

Opcjonalnie. Identyfikator produktu na koncie Merchant Center.
quantity

int64

Opcjonalnie. Liczba tego produktu powiązanego ze zdarzeniem.
unit_price

double

Opcjonalnie. Cena jednostkowa bez podatku, dostawy i wszelkich rabatów na poziomie transakcji.
item_id

string

Opcjonalnie. Unikalny identyfikator, który umożliwia odwoływanie się do elementu.
additional_item_parameters[]

ItemParameter

Opcjonalnie. Zbiór parametrów zdarzenia związanych z produktem, które mają być uwzględnione w zdarzeniu, a nie zostały jeszcze określone za pomocą innych pól strukturalnych.
merchant_id

string

Opcjonalnie. Identyfikator w Merchant Center powiązany z produktem. W przypadku zdarzeń związanych ze sprzedażą w sklepie stacjonarnym ta wartość zastąpi wartość ustawioną na poziomie koszyka. W przypadku innych zdarzeń to pole jest ignorowane.
merchant_feed_label

string

Opcjonalnie. Etykieta pliku danych Merchant Center. Jeśli nadal używasz krajów, możesz zamiast nich użyć 2-literowego kodu kraju w formacie ISO-3166-1 alfa-2. W przypadku zdarzeń związanych ze sprzedażą w sklepie stacjonarnym ta wartość zastąpi wartość ustawioną na poziomie koszyka. W przypadku innych zdarzeń to pole jest ignorowane.
merchant_feed_language_code

string

Opcjonalnie. Kod języka w formacie ISO 639-1 powiązany z plikiem danych Merchant Center, w którym przesyłane są Twoje produkty.
custom_variables[]

ItemCustomVariable

Opcjonalnie. Dodatkowe informacje o parach klucz/wartość, które mają być wysyłane do kontenerów konwersji (działania powodującego konwersję lub aktywności Floodlight) podczas śledzenia konwersji poszczególnych produktów.
conversion_value

double

Opcjonalnie. Wartość konwersji powiązana z tym elementem w zdarzeniu w przypadku, gdy wartość konwersji jest inna dla każdego elementu.

ItemCustomVariable

Zmienna niestandardowa na poziomie produktu na potrzeby konwersji z reklam.

Pola
variable

string

Opcjonalnie. Nazwa zmiennej niestandardowej do ustawienia. Jeśli zmienna nie zostanie znaleziona w przypadku danego miejsca docelowego, zostanie zignorowana.
value

string

Opcjonalnie. Wartość do zapisania w zmiennej niestandardowej.
destination_references[]

string

Opcjonalnie. Ciąg odniesienia używany do określania, do którego z Event.destination_references należy wysłać zmienną niestandardową. Jeśli pole jest puste, używana jest wartość Event.destination_references.

ItemParameter

Zbiór parametrów zdarzenia związanych z produktem, które mają być uwzględnione w zdarzeniu, a nie zostały jeszcze określone za pomocą innych pól strukturalnych.

Pola
parameter_name

string

Wymagane. Nazwa parametru do użycia.
value

string

Wymagane. Ciąg znaków reprezentujący wartość parametru do ustawienia.

ListUserListDirectLicensesRequest

Żądanie wyświetlenia listy wszystkich zasobów UserListDirectLicense na danym koncie.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
parent

string

Wymagane. Konto, którego licencje są sprawdzane. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
filter

string

Opcjonalnie. Ciąg filtra do zastosowania w żądaniu listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. user_list_id = 123). Pola muszą być określone w formacie camel case lub snake case. Nie używaj kombinacji camel case i snake case.

Obsługiwane operacje:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Nieobsługiwane pola:

  • name (zamiast tego użyj metody get)
  • historical_pricings i wszystkie jego pola podrzędne.
  • pricing.start_time
  • pricing.end_time
page_size

int32

Opcjonalnie. Maksymalna liczba licencji do zwrócenia na stronie. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 50 licencji. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania ListUserListDirectLicense. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji ListUserListDirectLicense muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListUserListDirectLicensesResponse

Odpowiedź z ListUserListDirectLicensesRequest.

Pola
user_list_direct_licenses[]

UserListDirectLicense

Licencje dla danej listy użytkowników w żądaniu.
next_page_token

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListUserListGlobalLicenseCustomerInfosRequest

Prośba o wyświetlenie wszystkich zasobów UserListGlobalLicenseCustomerInfo dla danej listy użytkowników z licencją globalną.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
parent

string

Wymagane. Licencja globalna, której dotyczy zapytanie o informacje o kliencie. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. Aby wyświetlić wszystkie informacje o klientach z globalną licencją na koncie, zastąp identyfikator globalnej licencji na liście użytkowników znakiem „-” (np. accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).
filter

string

Opcjonalnie. Ciąg filtra do zastosowania w żądaniu listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. user_list_id = 123). Pola muszą być określone w formacie camel case lub snake case. Nie używaj kombinacji camel case i snake case.

Obsługiwane operacje:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Nieobsługiwane pola:

  • name (zamiast tego użyj metody get)
  • historical_pricings i wszystkie jego pola podrzędne.
  • pricing.start_time
  • pricing.end_time
page_size

int32

Opcjonalnie. Maksymalna liczba licencji do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 50 licencji. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania ListUserListDirectLicense. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji ListUserListDirectLicense muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListUserListGlobalLicenseCustomerInfosResponse

Odpowiedź na [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].

Pola
user_list_global_license_customer_infos[]

UserListGlobalLicenseCustomerInfo

Informacje o kliencie dotyczące danej licencji w żądaniu.
next_page_token

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListUserListGlobalLicensesRequest

Żądanie wyświetlenia listy wszystkich zasobów UserListGlobalLicense na danym koncie.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
parent

string

Wymagane. Konto, którego licencje są sprawdzane. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
filter

string

Opcjonalnie. Ciąg filtra do zastosowania w żądaniu listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. user_list_id = 123). Pola muszą być określone w formacie camel case lub snake case. Nie używaj kombinacji camel case i snake case.

Obsługiwane operacje:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Nieobsługiwane pola:

  • name (zamiast tego użyj metody get)
  • historical_pricings i wszystkie jego pola podrzędne.
  • pricing.start_time
  • pricing.end_time
page_size

int32

Opcjonalnie. Maksymalna liczba licencji do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 50 licencji. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania ListUserListGlobalLicense. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji ListUserListDirectLicense muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListUserListGlobalLicensesResponse

Odpowiedź z ListUserListGlobalLicensesRequest.

Pola
user_list_global_licenses[]

UserListGlobalLicense

Licencje dla danej listy użytkowników w żądaniu.
next_page_token

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListUserListsRequest

Wiadomość żądania dla ListUserLists.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
parent

string

Wymagane. Konto nadrzędne, do którego należy ta kolekcja list użytkowników. Format: accountTypes/{account_type}/accounts/{account}
page_size

int32

Opcjonalnie. Maksymalna liczba list użytkowników do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie zostanie określona, zwracanych będzie maksymalnie 50 list użytkowników. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania ListUserLists. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji ListUserLists muszą być zgodne z wywołaniem, które dostarczyło token strony.
filter

string

Opcjonalnie. Ciąg znaków filtra. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. display_name = "list 1"). Pola muszą być określone w formacie camel case lub snake case. Nie używaj kombinacji camel case i snake case.

Obsługiwane operacje:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=
  • : (ma)

Obsługiwane pola:

  • id
  • display_name
  • description
  • membership_status
  • integration_code
  • access_reason
  • ingested_user_list_info.upload_key_types

ListUserListsResponse

Wiadomość odpowiedzi dla ListUserLists.

Pola
user_lists[]

UserList

Listy użytkowników z określonego konta.
next_page_token

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

MatchRateRange

Zakres współczynnika dopasowania przesłanych danych lub listy użytkowników.

Wartości w polu enum
MATCH_RATE_RANGE_UNKNOWN Zakres współczynnika dopasowania jest nieznany.
MATCH_RATE_RANGE_NOT_ELIGIBLE Zakres współczynnika dopasowania jest nieprawidłowy.
MATCH_RATE_RANGE_LESS_THAN_20 Zakres współczynnika dopasowania jest mniejszy niż 20% (w przedziale [0, 20)).
MATCH_RATE_RANGE_20_TO_30 Zakres współczynnika dopasowania wynosi od 20% do 30% (w przedziale [20, 31)).
MATCH_RATE_RANGE_31_TO_40 Zakres współczynnika dopasowania wynosi od 31% do 40% (w przedziale [31, 41)).
MATCH_RATE_RANGE_41_TO_50 Współczynnik dopasowania mieści się w zakresie od 41% do 50% (w przedziale [41, 51)).
MATCH_RATE_RANGE_51_TO_60 Zakres współczynnika dopasowania wynosi od 51% do 60% (w przedziale [51, 61).
MATCH_RATE_RANGE_61_TO_70 Współczynnik dopasowania mieści się w zakresie od 61% do 70% (w przedziale [61, 71)).
MATCH_RATE_RANGE_71_TO_80 Zakres współczynnika dopasowania wynosi od 71% do 80% (w przedziale [71, 81)).
MATCH_RATE_RANGE_81_TO_90 Zakres współczynnika dopasowania wynosi od 81% do 90% (w przedziale [81, 91)).
MATCH_RATE_RANGE_91_TO_100

Zakres współczynnika dopasowania wynosi od 91% do 100% (w przedziale [91, 100]).

MobileData

Identyfikatory mobilne odbiorców. Wymagany jest co najmniej 1 identyfikator mobilny.

Pola
mobile_ids[]

string

Wymagane. Lista identyfikatorów urządzeń mobilnych (identyfikatorów wyświetlania reklam lub IDFA). W jednym elemencie AudienceMember można podać maksymalnie 10 elementów mobileIds.

MobileIdInfo

Dodatkowe informacje, gdy MOBILE_ID jest jednym z upload_key_types.

Pola
data_source_type

DataSourceType

Opcjonalnie. Niezmienne. Źródło danych przesyłania.
key_space

KeySpace

Wymagane. Niezmienne. Przestrzeń kluczy identyfikatorów mobilnych.
app_id

string

Wymagane. Niezmienne. Ciąg znaków, który w niepowtarzalny sposób identyfikuje aplikację mobilną, z której zebrano dane.

KeySpace

Przestrzeń kluczy dla identyfikatora mobilnego.

Wartości w polu enum
KEY_SPACE_UNSPECIFIED Nie określono.
IOS Przestrzeń kluczy iOS.
ANDROID Przestrzeń kluczy Androida.

PairData

Identyfikatory PAIR dla odbiorców. Wymagany jest co najmniej 1 identyfikator PAIR.

Ta funkcja jest dostępna tylko dla partnerów danych.

Pola
pair_ids[]

string

Wymagane. Dane umożliwiające identyfikację dostarczone przez środowisko data clean room, zaszyfrowane algorytmem SHA256 i szyfrem przemiennym EC przy użyciu klucza wydawcy na potrzeby listy użytkowników PAIR. W jednym elemencie AudienceMember można podać maksymalnie 10 elementów pairIds.

PairIdInfo

Dodatkowe informacje, gdy PAIR_ID jest jednym z upload_key_types.

Ta funkcja jest dostępna tylko dla partnerów danych.

Pola
publisher_id

int64

Wymagane. Niezmienne. Określa wydawcę, z którym jest dopasowywana lista użytkowników dopasowywania danych o tożsamości użytkowników (PAIR). To pole jest dostarczane przez dostawcę usługi clean room i jest unikalne tylko w ramach tej usługi. Nie można go używać jako identyfikatora globalnego w wielu pomieszczeniach typu clean room.
publisher_name

string

Wymagane. Opisowa nazwa wydawcy, która będzie wyświetlana w interfejsie, aby zapewnić lepsze kierowanie.
match_rate_percentage

int32

Wymagane. To pole oznacza odsetek dopasowania użytkowników na tej liście do danych własnych odpowiedniego wydawcy. Musi mieścić się w zakresie od 0 do 100 włącznie.
advertiser_identifier_count

int64

Opcjonalnie. Liczba rekordów danych własnych reklamodawcy, które zostały przesłane do dostawcy usługi data clean room. Nie oznacza to rozmiaru listy użytkowników PAIR.
clean_room_identifier

string

Wymagane. Niezmienne. Identyfikuje unikalną relację reklamodawca–wydawca z jednym lub kilkoma dostawcami usług data clean room.

PartnerAudienceInfo

Dodatkowe informacje o odbiorcach partnerów.

Ta funkcja jest dostępna tylko dla partnerów danych.

Pola
partner_audience_source

PartnerAudienceSource

Wymagane. Niezmienne. Źródło danych o odbiorcach partnera.
commerce_partner

string

Opcjonalnie. Nazwa partnera handlowego. Dozwolone tylko wtedy, gdy partner_audience_source ma wartość COMMERCE_AUDIENCE.

PartnerAudienceSource

Źródło danych o odbiorcach partnera.

Wartości w polu enum
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED Nie określono.
COMMERCE_AUDIENCE Źródłem danych o odbiorcach partnera są handlowe listy odbiorców.
LINEAR_TV_AUDIENCE Źródłem danych o odbiorcach partnera są odbiorcy telewizji linearnej.
AGENCY_PROVIDER_AUDIENCE Źródłem danych o odbiorcach partnera są listy odbiorców agencji lub dostawców.

PpidData

Dane identyfikatorów podawanych przez wydawcę zawierające identyfikatory PPID. Wymagany jest co najmniej 1 identyfikator PPID.

Ta funkcja jest dostępna tylko dla partnerów danych.

Pola
ppids[]

string

Wymagane. Lista identyfikatorów podawanych przez wydawców dla użytkownika.

ProcessingErrorReason

Przyczyna błędu przetwarzania. W przyszłości możemy dodać nowe powody.

Wartości w polu enum
PROCESSING_ERROR_REASON_UNSPECIFIED Przyczyna błędu przetwarzania jest nieznana.
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE Zmienna niestandardowa jest nieprawidłowa.
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED Stan zmiennej niestandardowej nie jest włączony.
PROCESSING_ERROR_REASON_EVENT_TOO_OLD Konwersja jest starsza niż maksymalny obsługiwany wiek.
PROCESSING_ERROR_REASON_DUPLICATE_GCLID W systemie istnieje już konwersja z tym samym identyfikatorem kliknięcia Google i czasem konwersji.
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID Konwersja z tą samą kombinacją identyfikatora zamówienia i działania powodującego konwersję została już przesłana.
PROCESSING_ERROR_REASON_INVALID_GBRAID Nie udało się zdekodować parametru gbraid.
PROCESSING_ERROR_REASON_INVALID_GCLID Nie udało się zdekodować identyfikatora kliknięcia Google.
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID Identyfikator sprzedawcy zawiera znaki inne niż cyfry.
PROCESSING_ERROR_REASON_INVALID_WBRAID Nie udało się zdekodować parametru wbraid.
PROCESSING_ERROR_REASON_INTERNAL_ERROR Błąd wewnętrzny.
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Warunki korzystania z konwersji rozszerzonych nie zostały podpisane na koncie docelowym.
PROCESSING_ERROR_REASON_INVALID_EVENT Wydarzenie jest nieprawidłowe.
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS Liczba dopasowanych transakcji jest mniejsza niż minimalny próg.
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS Transakcje są poniżej minimalnego progu.
PROCESSING_ERROR_REASON_INVALID_FORMAT Wydarzenie ma błąd formatu.
PROCESSING_ERROR_REASON_DECRYPTION_ERROR Wydarzenie zawiera błąd odszyfrowywania.
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR Nie udało się odszyfrować klucza DEK.
PROCESSING_ERROR_REASON_INVALID_WIP Identyfikator WIP ma nieprawidłowy format lub nie istnieje.
PROCESSING_ERROR_REASON_INVALID_KEK Klucz KEK nie może odszyfrować danych, ponieważ jest nieprawidłowy lub nie istnieje.
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED Nie można było użyć tożsamości WIP, ponieważ została odrzucona przez warunek atestu.
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED System nie miał uprawnień potrzebnych do uzyskania dostępu do klucza KEK.
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED Nie udało się uwierzytelnić w AWS.
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR Nie udało się odszyfrować danych UserIdentifier za pomocą klucza DEK.
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER Użytkownik próbował przesyłać zdarzenia z identyfikatorem reklamy, który nie pochodzi z reklam na koncie operacyjnym.
PROCESSING_ERROR_REASON_ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID W przypadku parametrów BRAID nie można używać działań powodujących konwersję, które zliczają 1 konwersję na kliknięcie.
PROCESSING_ERROR_REASON_MATCH_ID_NOT_FOUND Nie można znaleźć identyfikatora dopasowania.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_MATCH_ID Nie można znaleźć identyfikatora użytkownika dla identyfikatora dopasowania.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_GCLID Nie udało się znaleźć identyfikatora użytkownika dla identyfikatora kliknięcia Google.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_DCLID Nie można znaleźć identyfikatora użytkownika dla identyfikatora DCLID.
PROCESSING_ERROR_REASON_INVALID_AD_IDENTIFIERS Występują nieprawidłowe identyfikatory reklam.
PROCESSING_ERROR_REASON_INVALID_MOBILE_ID_FORMAT Format identyfikatora urządzenia mobilnego jest nieprawidłowy.
PROCESSING_ERROR_REASON_ORIGINAL_CONVERSIONS_NOT_FOUND Nie udało się znaleźć pierwotnych konwersji.
PROCESSING_ERROR_REASON_EVENT_ID_DECODE_ERROR Nie można zdekodować identyfikatora zdarzenia (dclid lub identyfikatora wyświetlenia).
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_IMPRESSION_ID Nie można znaleźć identyfikatora użytkownika dla podanego identyfikatora wyświetlenia.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND Nie można znaleźć identyfikatora użytkownika.
PROCESSING_ERROR_REASON_CONVERSION_PRECEDES_CLICK Sygnatura czasowa zdarzenia była wcześniejsza niż powiązane kliknięcie.
PROCESSING_ERROR_REASON_TOO_RECENT_CLICK Kliknięcie nastąpiło zbyt niedawno.
PROCESSING_ERROR_REASON_INVALID_CLICK Nie można przypisać zdarzenia do kliknięcia (identyfikatora kliknięcia Google). Być może źródłem kliknięcia nie była np. kampania Google Ads.
PROCESSING_ERROR_REASON_INVALID_OPERATING_ACCOUNT_FOR_CLICK Kliknięcie ze zdarzenia nie jest powiązane z operating_account miejsca docelowego.
PROCESSING_ERROR_REASON_CLICK_NOT_FOUND Nie można znaleźć odpowiedniego kliknięcia pasującego do podanych atrybutów.

ProcessingWarningReason

Powód ostrzeżenia dotyczącego przetwarzania.

Wartości w polu enum
PROCESSING_WARNING_REASON_UNSPECIFIED Przyczyna ostrzeżenia o przetwarzaniu jest nieznana.
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED System nie miał uprawnień potrzebnych do uzyskania dostępu do klucza KEK.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR Nie udało się odszyfrować klucza DEK.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR Wydarzenie zawiera błąd odszyfrowywania.
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED Nie można było użyć tożsamości WIP, ponieważ została odrzucona przez warunek atestu.
PROCESSING_WARNING_REASON_INVALID_WIP Identyfikator WIP ma nieprawidłowy format lub nie istnieje.
PROCESSING_WARNING_REASON_INVALID_KEK Klucz KEK nie może odszyfrować danych, ponieważ jest nieprawidłowy lub nie istnieje.
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR Nie udało się odszyfrować danych UserIdentifier za pomocą klucza DEK.
PROCESSING_WARNING_REASON_INTERNAL_ERROR Błąd wewnętrzny.
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED Nie udało się uwierzytelnić w AWS.

Produkt

Rola wycofana. Zamiast niej używaj zasady AccountType. Reprezentuje konkretną usługę Google.

Wartości w polu enum
PRODUCT_UNSPECIFIED Nieokreślony produkt. Nigdy nie należy go używać.
GOOGLE_ADS Google Ads,
DISPLAY_VIDEO_PARTNER partnera Display & Video 360.
DISPLAY_VIDEO_ADVERTISER reklamodawcą Display & Video 360;
DATA_PARTNER Dostawca danych.

ProductAccount

Reprezentuje konkretne konto.

Pola
product
(deprecated)

Product

Rola wycofana. Zamiast niej używaj zasady account_type.
account_id

string

Wymagane. Identyfikator konta. Na przykład identyfikator konta Google Ads.
account_type

AccountType

Opcjonalnie. Typ konta. Na przykład: GOOGLE_ADS. Wymagane jest pole account_type lub wycofane pole product. Jeśli oba są ustawione, wartości muszą być zgodne.

AccountType

Reprezentuje typy kont Google. Służy do lokalizowania kont i miejsc docelowych.

Wartości w polu enum
ACCOUNT_TYPE_UNSPECIFIED Nieokreślony produkt. Nigdy nie należy go używać.
GOOGLE_ADS Google Ads,
DISPLAY_VIDEO_PARTNER partnera Display & Video 360.
DISPLAY_VIDEO_ADVERTISER reklamodawcą Display & Video 360;
DATA_PARTNER Dostawca danych.
GOOGLE_ANALYTICS_PROPERTY Google Analytics.
FLOODLIGHT_CONFIG Konfiguracja Floodlight.

PseudonymousIdInfo

Dodatkowe informacje, gdy PSEUDONYMOUS_ID jest jednym z upload_key_types.

Pola
sync_status

SyncStatus

Tylko dane wyjściowe. Stan synchronizacji listy użytkowników.
billable_record_count

int64

Opcjonalnie. Niezmienne. Liczba rekordów podlegających rozliczeniu (np. przesłanych lub dopasowanych).

SyncStatus

Stan synchronizacji listy użytkowników.

Wartości w polu enum
SYNC_STATUS_UNSPECIFIED Nie określono.
CREATED Lista użytkowników została utworzona jako element zastępczy. Lista zawartości lub metadane są nadal synchronizowane. Lista użytkowników nie jest gotowa do użycia.
READY_FOR_USE Lista użytkowników jest gotowa do użycia. Treści i pliki cookie zostały prawidłowo zsynchronizowane.
FAILED Podczas synchronizacji zawartości lub metadanych listy użytkowników wystąpił błąd. Nie można użyć listy użytkowników.

RemoveAudienceMembersRequest

Prośba o usunięcie użytkowników z grupy odbiorców w podanych miejscach docelowych. Zwraca wartość RemoveAudienceMembersResponse.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
destinations[]

Destination

Wymagane. Lista miejsc docelowych, z których chcesz usunąć użytkowników.
audience_members[]

AudienceMember

Wymagane. Lista użytkowników do usunięcia.
validate_only

bool

Opcjonalnie. Do celów testowych. Jeśli true, żądanie jest weryfikowane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki.
encoding

Encoding

Opcjonalnie. Wymagane w przypadku przesyłania plików UserData. Typ kodowania identyfikatorów użytkowników. Dotyczy tylko zewnętrznego kodowania zaszyfrowanych identyfikatorów użytkowników. W przypadku przesyłania plików innych niż UserData to pole jest ignorowane.
encryption_info

EncryptionInfo

Opcjonalnie. Informacje o szyfrowaniu przesyłanych plików w UserData. Jeśli nie jest ustawiona, zakłada się, że przesłane informacje umożliwiające identyfikację są zahaszowane, ale nie zaszyfrowane. W przypadku przesyłania plików innych niż UserData to pole jest ignorowane.

RemoveAudienceMembersResponse

Odpowiedź z RemoveAudienceMembersRequest.

Pola
request_id

string

Automatycznie wygenerowany identyfikator żądania.

RequestStatusPerDestination

Stan żądania dla każdego miejsca docelowego.

Pola
destination

Destination

Miejsce docelowe w żądaniu do interfejsu DM API.
request_status

RequestStatus

Stan żądania miejsca docelowego.
error_info

ErrorInfo

Informacje o błędzie zawierające przyczynę błędu i liczbę błędów związanych z przesyłaniem. Wartość jest podawana tylko wtedy, gdy element request_status ma wartość FAILED lub PARTIAL_SUCCESS. To pole jest puste, gdy żądanie ma wartość request_status z PROCESSING.
warning_info

WarningInfo

Informacje ostrzegawcze zawierające powód ostrzeżenia i liczbę ostrzeżeń związanych z przesłanym plikiem. To pole jest puste, gdy żądanie ma wartość request_status z PROCESSING.
Pole zbiorcze status. Stan miejsca docelowego. status może mieć tylko jedną z tych wartości:
audience_members_ingestion_status

IngestAudienceMembersStatus

Stan żądania dotyczącego przesyłania danych o odbiorcach.
events_ingestion_status

IngestEventsStatus

Stan żądania dotyczącego zdarzeń przesyłanych do systemu.
audience_members_removal_status

RemoveAudienceMembersStatus

Stan prośby o usunięcie członków grupy odbiorców.

DataType

Typ danych.

Wartości w polu enum
DATA_TYPE_UNSPECIFIED Typ danych nie jest określony.
EMAIL Dane to adres e-mail.
PHONE_NUMBER Dane to numer telefonu.
ADDRESS Dane to adres pocztowy.
IP_ADDRESS Dane to adres IP.

DataTypeCount

Liczba dla określonego typu danych.

Pola
type

DataType

Typ danych.
count

int64

Liczba tego typu danych.

IngestAudienceMembersStatus

Stan żądania dotyczącego przesyłania danych o odbiorcach.

Pola
Pole zbiorcze status. Stan przesyłania danych o członkach listy odbiorców do usługi docelowej. status może mieć tylko jedną z tych wartości:
user_data_ingestion_status

IngestUserDataStatus

Stan pozyskiwania danych użytkownika do miejsca docelowego.
mobile_data_ingestion_status

IngestMobileDataStatus

Stan pozyskiwania danych mobilnych do miejsca docelowego.
pair_data_ingestion_status

IngestPairDataStatus

Stan pozyskiwania danych o parach w miejscu docelowym.
user_id_data_ingestion_status

IngestUserIdDataStatus

Stan pozyskiwania danych identyfikatora użytkownika w miejscu docelowym.
ppid_data_ingestion_status

IngestPpidDataStatus

Stan pozyskiwania danych PPID w miejscu docelowym.
composite_data_ingestion_status

IngestCompositeDataStatus

Stan pozyskiwania danych złożonych do miejsca docelowego.

IngestCompositeDataStatus

Stan pozyskiwania danych złożonych do miejsca docelowego zawierającego statystyki związane z pozyskiwaniem.

Pola
record_count

int64

Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich członków listy odbiorców w żądaniu, niezależnie od tego, czy zostali przetworzeni.
data_type_counts[]

DataTypeCount

Łączna liczba typów danych wysłanych w żądaniu przesłania do miejsca docelowego, podzielona według typu danych. Obejmuje wszystkie typy danych w żądaniu, niezależnie od tego, czy zostały przetworzone.
upload_match_rate_range

MatchRateRange

Zakres współczynnika dopasowania przesyłanych danych.

IngestEventsStatus

Stan przesyłania zdarzeń do miejsca docelowego.

Pola
record_count

int64

Łączna liczba zdarzeń wysłanych w żądaniu przesyłania. Obejmuje wszystkie zdarzenia w żądaniu, niezależnie od tego, czy zostały przetworzone.

IngestMobileDataStatus

Stan pozyskiwania danych mobilnych do miejsca docelowego zawierającego statystyki związane z pozyskiwaniem danych.

Pola
record_count

int64

Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich członków listy odbiorców w żądaniu, niezależnie od tego, czy zostali przetworzeni.
mobile_id_count

int64

Łączna liczba identyfikatorów urządzeń mobilnych wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkie identyfikatory mobilne w żądaniu, niezależnie od tego, czy zostały przetworzone.

IngestPairDataStatus

Stan pozyskiwania danych o parach do miejsca docelowego zawierającego statystyki związane z pozyskiwaniem.

Pola
record_count

int64

Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich członków listy odbiorców w żądaniu, niezależnie od tego, czy zostali przetworzeni.
pair_id_count

int64

Łączna liczba identyfikatorów par wysłanych w żądaniu przesłania do miejsca docelowego. Obejmuje wszystkie identyfikatory par w żądaniu, niezależnie od tego, czy zostały przetworzone.

IngestPpidDataStatus

Stan pozyskiwania danych PPID do miejsca docelowego zawierającego statystyki związane z pozyskiwaniem.

Pola
record_count

int64

Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich członków listy odbiorców w żądaniu, niezależnie od tego, czy zostali przetworzeni.
ppid_count

int64

Łączna liczba identyfikatorów PPID wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkie identyfikatory PPID w żądaniu, niezależnie od tego, czy zostały przetworzone.

IngestUserDataStatus

Stan pozyskiwania danych użytkownika do miejsca docelowego zawierającego statystyki związane z pozyskiwaniem danych.

Pola
record_count

int64

Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich członków listy odbiorców w żądaniu, niezależnie od tego, czy zostali przetworzeni.
user_identifier_count

int64

Łączna liczba identyfikatorów użytkowników wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkie identyfikatory użytkowników w żądaniu, niezależnie od tego, czy zostały one przetworzone.
upload_match_rate_range

MatchRateRange

Zakres współczynnika dopasowania przesyłanych danych.

IngestUserIdDataStatus

Stan pozyskiwania danych identyfikatora użytkownika do miejsca docelowego zawierającego statystyki związane z pozyskiwaniem.

Pola
record_count

int64

Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich członków listy odbiorców w żądaniu, niezależnie od tego, czy zostali przetworzeni.
user_id_count

int64

Łączna liczba identyfikatorów użytkowników wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkie identyfikatory użytkowników w żądaniu, niezależnie od tego, czy zostały przetworzone.

RemoveAudienceMembersStatus

Stan prośby o usunięcie członków grupy odbiorców.

Pola
Pole zbiorcze status. Stan usunięcia członków listy odbiorców z miejsca docelowego. status może mieć tylko jedną z tych wartości:
user_data_removal_status

RemoveUserDataStatus

Stan usunięcia danych użytkownika z miejsca docelowego.
mobile_data_removal_status

RemoveMobileDataStatus

Stan usunięcia danych mobilnych z miejsca docelowego.
pair_data_removal_status

RemovePairDataStatus

Stan usunięcia danych z miejsca docelowego.
user_id_data_removal_status

RemoveUserIdDataStatus

Stan usuwania danych identyfikatora użytkownika z miejsca docelowego.
ppid_data_removal_status

RemovePpidDataStatus

Stan usuwania danych PPID z miejsca docelowego.
composite_data_removal_status

RemoveCompositeDataStatus

Stan usunięcia danych złożonych z miejsca docelowego.

RemoveCompositeDataStatus

Stan usunięcia danych złożonych z miejsca docelowego.

Pola
record_count

int64

Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali usunięci.
data_type_counts[]

DataTypeCount

Łączna liczba typów danych wysłanych w żądaniu usunięcia, podzielona według typu danych. Obejmuje wszystkie typy danych w żądaniu, niezależnie od tego, czy zostały usunięte.

RemoveMobileDataStatus

Stan usunięcia danych mobilnych z miejsca docelowego.

Pola
record_count

int64

Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali usunięci.
mobile_id_count

int64

Łączna liczba identyfikatorów urządzeń mobilnych wysłanych w żądaniu usunięcia. Obejmuje wszystkie identyfikatory mobilne w żądaniu, niezależnie od tego, czy zostały usunięte.

RemovePairDataStatus

Stan usunięcia danych z miejsca docelowego.

Pola
record_count

int64

Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali usunięci.
pair_id_count

int64

Łączna liczba identyfikatorów par wysłanych w żądaniu usunięcia. Obejmuje wszystkie identyfikatory par w żądaniu, niezależnie od tego, czy zostały usunięte.

RemovePpidDataStatus

Stan usuwania danych PPID z miejsca docelowego.

Pola
record_count

int64

Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali usunięci.
ppid_count

int64

Łączna liczba identyfikatorów PPID przesłanych w żądaniu usunięcia. Obejmuje wszystkie identyfikatory PPID w żądaniu, niezależnie od tego, czy zostały usunięte.

RemoveUserDataStatus

Stan usunięcia danych użytkownika z miejsca docelowego.

Pola
record_count

int64

Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali usunięci.
user_identifier_count

int64

Łączna liczba identyfikatorów użytkowników przesłanych w żądaniu usunięcia. Obejmuje wszystkie identyfikatory użytkowników w żądaniu, niezależnie od tego, czy zostały one usunięte.

RemoveUserIdDataStatus

Stan usuwania danych identyfikatora użytkownika z miejsca docelowego.

Pola
record_count

int64

Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali usunięci.
user_id_count

int64

Łączna liczba identyfikatorów użytkowników przesłanych w żądaniu usunięcia. Obejmuje wszystkie identyfikatory użytkowników w żądaniu, niezależnie od tego, czy zostały one usunięte.

RequestStatus

Stan żądania.

Wartości w polu enum
REQUEST_STATUS_UNKNOWN Stan prośby jest nieznany.
SUCCESS Przetwarzanie wszystkich rekordów zakończyło się bez błędów. W polu warning_info mogą jednak pojawić się ostrzeżenia.
PROCESSING Żądanie jest przetwarzane.
FAILED Przetwarzanie wszystkich rekordów nie powiodło się. Szczegóły błędów znajdziesz w polu error_info, a szczegóły ostrzeżeń – w polu warning_info.
PARTIAL_SUCCESS Przetwarzanie niektórych rekordów zakończyło się pomyślnie bez błędów, ale w przypadku innych rekordów wystąpiły błędy. Szczegóły błędów znajdziesz w polu error_info, a szczegóły ostrzeżeń – w polu warning_info.

RetrieveInsightsRequest

Komunikat z prośbą o wywołanie interfejsu DM API MarketingDataInsightsService.RetrieveInsights

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
parent

string

Wymagane. Konto nadrzędne, do którego należy lista użytkowników. Format: accountTypes/{account_type}/accounts/{account}
baseline

Baseline

Wymagane. Wartość bazowa dla żądanych statystyk.
user_list_id

string

Wymagane. Identyfikator listy użytkowników, dla której są wymagane statystyki.

RetrieveInsightsResponse

Komunikat odpowiedzi interfejsu DM API MarketingDataInsightsService.RetrieveInsights

Pola
marketing_data_insights[]

MarketingDataInsight

Zawiera statystyki dotyczące danych marketingowych.

MarketingDataInsight

Statystyki dotyczące danych marketingowych.

Ta funkcja jest dostępna tylko dla partnerów danych.

Pola
dimension

AudienceInsightsDimension

Wymiar, do którego należy statystyka.
attributes[]

MarketingDataInsightsAttribute

Statystyki dotyczące wartości danego wymiaru.

AudienceInsightsDimension

Wymiary, których można używać do generowania statystyk.

Wartości w polu enum
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Nie określono.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN W tej wersji wartość jest nieznana.
AFFINITY_USER_INTEREST Zainteresowanie użytkownika o podobnych zainteresowaniach.
IN_MARKET_USER_INTEREST Zainteresowanie użytkownika na rynku.
AGE_RANGE przedział wiekowy,
GENDER Płeć.

MarketingDataInsightsAttribute

Statystyki dotyczące kolekcji powiązanych atrybutów tego samego wymiaru.

Pola
user_interest_id

int64

Identyfikator zainteresowania użytkownika.
lift

float

Miara wzrostu, jaki grupa odbiorców wywołuje w przypadku wartości atrybutu w porównaniu z wartością bazową. Zakres [0–1].
age_range

AgeRange

Przedział wiekowy odbiorców, dla których podany jest wzrost.
gender

Gender

Płeć odbiorców, dla których podano wzrost.

RetrieveRequestStatusRequest

Żądanie pobrania stanu żądania wysłanego do interfejsu DM API dla danego identyfikatora żądania. Zwraca wartość RetrieveRequestStatusResponse.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
request_id

string

Wymagane. Wymagane. Identyfikator żądania do interfejsu Data Manager API.

RetrieveRequestStatusResponse

Odpowiedź z RetrieveRequestStatusRequest.

Pola
request_status_per_destination[]

RequestStatusPerDestination

Lista stanów żądań dla każdego miejsca docelowego. Kolejność stanów odpowiada kolejności miejsc docelowych w pierwotnym żądaniu.

SearchPartnerLinksRequest

Prośba o wyszukanie zasobów PartnerLink. Zwraca wartość SearchPartnerLinksResponse.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
parent

string

Wymagane. Konto, na którym chcesz wyszukać linki partnerów. Jeśli nie podasz wartości filter, zwrócimy wszystkie linki partnerskie, w których to konto jest owning_account lub partner_account.

Format: accountTypes/{account_type}/accounts/{account}
page_size

int32

Maksymalna liczba linków partnerskich do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podano tego argumentu, zwracanych będzie maksymalnie 10 linków partnerskich. Maksymalna wartość to 100. Wartości powyżej 100 zostaną przekształcone w 100.
page_token

string

Token strony otrzymany z poprzedniego wywołania SearchPartnerLinks. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji SearchPartnerLinks muszą być zgodne z wywołaniem, które dostarczyło token strony.
filter

string

Opcjonalnie. Ciąg znaków filtra. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. partner_link_id = 123456789). Pola muszą być określone w formacie camel case lub snake case. Nie używaj kombinacji camel case i snake case.

Obsługiwane operacje:

  • AND
  • =
  • !=

Obsługiwane pola:

  • partner_link_id
  • owning_account.account_type
  • owning_account.account_id
  • partner_account.account_type
  • partner_account.account_id

Przykład: owning_account.account_type = "GOOGLE_ADS" AND partner_account.account_id = 987654321

SearchPartnerLinksResponse

Odpowiedź z SearchPartnerLinksRequest.

Pola
next_page_token

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

SizeInfo

Szacunkowa liczba użytkowników na tej liście w różnych sieciach docelowych.

Pola
display_network_members_count

int64

Tylko dane wyjściowe. Szacunkowa liczba użytkowników na tej liście w sieci reklamowej Google.
search_network_members_count

int64

Tylko dane wyjściowe. Szacunkowa liczba członków na tej liście użytkowników w domenie google.com. Są to elementy dostępne do kierowania w kampaniach w sieci wyszukiwania.
youtube_members_count

int64

Tylko dane wyjściowe. Szacunkowa liczba członków na tej liście użytkowników w YouTube.
gmail_members_count

int64

Tylko dane wyjściowe. Szacunkowa liczba użytkowników na tej liście w Gmailu.

TargetNetworkInfo

Informacje o spełnianiu wymagań w przypadku różnych sieci docelowych.

Pola
eligible_for_display

bool

Tylko dane wyjściowe. Wskazuje, że ta lista użytkowników kwalifikuje się do użycia w sieci reklamowej Google.

TermsOfService

Warunki korzystania z usługi, które użytkownik zaakceptował lub odrzucił.

Pola
customer_match_terms_of_service_status

TermsOfServiceStatus

Opcjonalnie. Warunki korzystania z funkcji kierowania na listę klientów: https://support.google.com/adspolicy/answer/6299717. Musisz zaakceptować te warunki, gdy przesyłasz dane UserData lub MobileData. To pole nie jest wymagane w przypadku listy użytkowników Dopasowywania partnerów.

TermsOfServiceStatus

Określa, czy rozmówca zaakceptował warunki usługi.

Wartości w polu enum
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Nie określono.
ACCEPTED Stan wskazujący, że dzwoniący zaakceptował warunki usługi.
REJECTED Stan wskazujący, że dzwoniący odrzucił warunki usługi.

UpdateUserListDirectLicenseRequest

Prośba o zaktualizowanie zasobu UserListDirectLicense.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
user_list_direct_license

UserListDirectLicense

Wymagane. Pole name licencji służy do identyfikowania licencji, która ma zostać zaktualizowana.
update_mask

FieldMask

Opcjonalnie. Lista pól do zaktualizowania. Znak specjalny * nie jest obsługiwany i w przypadku jego użycia zostanie zgłoszony błąd INVALID_UPDATE_MASK.

UpdateUserListGlobalLicenseRequest

Prośba o zaktualizowanie zasobu UserListGlobalLicense.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
user_list_global_license

UserListGlobalLicense

Wymagane. Pole name licencji służy do identyfikowania licencji, która ma zostać zaktualizowana.
update_mask

FieldMask

Opcjonalnie. Lista pól do zaktualizowania. Znak specjalny * nie jest obsługiwany i w przypadku jego użycia zostanie zgłoszony błąd INVALID_UPDATE_MASK.

UpdateUserListRequest

Wiadomość z prośbą o wywołanie funkcji UpdateUserList.

Możesz wypróbować tę metodę w narzędziu do eksplorowania interfejsów API REST:
Wypróbuj z REST
Pola
user_list

UserList

Wymagane. Lista użytkowników do zaktualizowania.

Pole name listy użytkowników służy do identyfikowania listy użytkowników, którą chcesz zaktualizować. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
update_mask

FieldMask

Opcjonalnie. Lista pól do zaktualizowania.
validate_only

bool

Opcjonalnie. Jeśli wartość to prawda, żądanie jest weryfikowane, ale nie wykonywane.

UserData

Dane, które identyfikują użytkownika. Wymagany jest co najmniej 1 identyfikator.

Pola
user_identifiers[]

UserIdentifier

Wymagane. Identyfikatory użytkownika. Możesz podać wiele wystąpień tego samego typu danych (np. wiele adresów e-mail). Aby zwiększyć prawdopodobieństwo dopasowania, podaj jak najwięcej identyfikatorów. W jednym elemencie AudienceMember lub Event można podać maksymalnie 10 wartości userIdentifiers.

UserIdData

Dane identyfikatora użytkownika zawierające identyfikator użytkownika.

Pola
user_id

string

Wymagane. Unikalny identyfikator użytkownika zdefiniowany przez reklamodawcę.

UserIdInfo

Dodatkowe informacje, gdy USER_ID jest jednym z upload_key_types.

Pola
data_source_type

DataSourceType

Opcjonalnie. Niezmienne. Źródło danych przesyłania.

UserIdentifier

Pojedynczy identyfikator użytkownika.

Pola
Pole zbiorcze identifier. Musisz podać dokładnie jedną wartość. identifier może mieć tylko jedną z tych wartości:
email_address

string

Zahaszowany adres e-mail za pomocą funkcji SHA-256 po normalizacji.
phone_number

string

Zahaszowany numer telefonu za pomocą funkcji SHA-256 po normalizacji (standard E164).
address

AddressInfo

Znane elementy adresu użytkownika. Zawiera grupę identyfikatorów, które są dopasowywane jednocześnie.

UserList

Materiał związany z listą użytkowników.

Pola
name

string

Identyfikator. Nazwa zasobu listy użytkowników. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
id

int64

Tylko dane wyjściowe. Unikalny identyfikator listy użytkowników.
read_only

bool

Tylko dane wyjściowe. Opcja, która określa, czy użytkownik może edytować listę.
membership_duration

Duration

Opcjonalnie. Okres, przez jaki użytkownik pozostaje na liście użytkowników. Prawidłowe okresy trwania to dokładne wielokrotności 24 godzin (86 400 sekund). Podanie wartości, która nie jest dokładną wielokrotnością 24 godzin, spowoduje błąd INVALID_ARGUMENT.
access_reason

AccessReason

Tylko dane wyjściowe. Powód, dla którego to konto ma dostęp do listy.
size_info

SizeInfo

Tylko dane wyjściowe. Szacunkowa liczba użytkowników na tej liście w różnych sieciach docelowych.
target_network_info

TargetNetworkInfo

Opcjonalnie. Informacje o spełnianiu wymagań w przypadku różnych sieci docelowych.
display_name

string

Wymagane. Wyświetlana nazwa listy użytkowników.
description

string

Opcjonalnie. Opis listy użytkowników.
membership_status

MembershipStatus

Opcjonalnie. Stan członkostwa na tej liście użytkowników.
integration_code

string

Opcjonalnie. Identyfikator z systemu zewnętrznego. Jest on używany przez sprzedawców list użytkowników do korelowania identyfikatorów w ich systemach.
closing_reason

ClosingReason

Tylko dane wyjściowe. Powód zamknięcia stanu członkostwa na liście użytkowników.
account_access_status

AccessStatus

Opcjonalnie. Wskazuje, czy udostępnianie jest nadal włączone. Gdy lista użytkowników jest udostępniana kontu, to pole ma wartość ENABLED. Właściciel listy użytkowników może później cofnąć udostępnianie i ustawić je jako DISABLED.
Pole zbiorcze user_list_info. Dodatkowe informacje o liście użytkowników. user_list_info może mieć tylko jedną z tych wartości:
ingested_user_list_info

IngestedUserListInfo

Opcjonalnie. Reprezentuje listę użytkowników wypełnianą na podstawie danych przesłanych przez użytkowników.

AccessReason

Wyliczenie opisujące możliwe przyczyny dostępu.

Wartości w polu enum
ACCESS_REASON_UNSPECIFIED Nie określono.
OWNED Zasób jest własnością użytkownika.
SHARED Zasób jest udostępniany użytkownikowi.
LICENSED Zasób jest licencjonowany dla użytkownika.
SUBSCRIBED Użytkownik zasubskrybował zasób.
AFFILIATED Zasób jest dostępny dla użytkownika.

AccessStatus

Wskazuje, czy ten klient nadal ma dostęp do listy.

Wartości w polu enum
ACCESS_STATUS_UNSPECIFIED Nie określono.
ENABLED Dostęp jest włączony.
DISABLED Dostęp jest wyłączony.

ClosingReason

Wskazuje powód zamknięcia listy użytkowników. Ten typ wyliczeniowy jest używany tylko wtedy, gdy lista jest automatycznie zamykana przez system.

Wartości w polu enum
CLOSING_REASON_UNSPECIFIED Nie określono.
UNUSED Lista użytkowników została zamknięta, ponieważ nie była ostatnio używana do kierowania. Więcej informacji znajdziesz na stronie https://support.google.com/google-ads/answer/2472738.

MembershipStatus

Stan listy użytkowników.

Wartości w polu enum
MEMBERSHIP_STATUS_UNSPECIFIED Nie określono.
OPEN Otwarty – lista użytkowników gromadzi członków i można na nią kierować reklamy.
CLOSED Stan zamknięty – nie są dodawani nowi użytkownicy.

UserListDirectLicense

Licencja bezpośrednia na listę użytkowników.

Ta funkcja jest dostępna tylko dla partnerów danych.

Pola
name

string

Identyfikator. Nazwa zasobu licencji bezpośredniej listy użytkowników.
user_list_display_name

string

Tylko dane wyjściowe. Nazwa listy użytkowników, na którą przyznawana jest licencja.

To pole jest tylko do odczytu.
client_account_display_name

string

Tylko dane wyjściowe. Nazwa klienta, któremu licencjonowana jest lista użytkowników.

To pole jest tylko do odczytu.
pricing

UserListLicensePricing

Opcjonalnie. Ceny UserListDirectLicense.
historical_pricings[]

UserListLicensePricing

Tylko dane wyjściowe. Historia cen licencji na tę listę użytkowników.

To pole jest tylko do odczytu.
metrics

UserListLicenseMetrics

Tylko dane wyjściowe. Dane związane z tą licencją

To pole jest tylko do odczytu i jest wypełniane tylko wtedy, gdy daty rozpoczęcia i zakończenia są ustawione w wywołaniu ListUserListDirectLicenses.
user_list_id

int64

Niezmienne. Identyfikator listy użytkowników, na którą przyznawana jest licencja.
client_account_type

UserListLicenseClientAccountType

Niezmienne. Typ konta klienta, na które licencjonowana jest lista użytkowników.
client_account_id

int64

Niezmienne. Identyfikator klienta, któremu licencjonowana jest lista użytkowników.
status

UserListLicenseStatus

Opcjonalnie. Stan UserListDirectLicense – ENABLED lub DISABLED.

UserListGlobalLicense

Licencja globalna na listę użytkowników.

Ta funkcja jest dostępna tylko dla partnerów danych.

Pola
name

string

Identyfikator. Nazwa zasobu globalnej licencji na listę użytkowników.
user_list_display_name

string

Tylko dane wyjściowe. Nazwa listy użytkowników, na którą przyznawana jest licencja.

To pole jest tylko do odczytu.
pricing

UserListLicensePricing

Opcjonalnie. Ceny UserListGlobalLicense.
historical_pricings[]

UserListLicensePricing

Tylko dane wyjściowe. Historia cen licencji na tę listę użytkowników.

To pole jest tylko do odczytu.
metrics

UserListLicenseMetrics

Tylko dane wyjściowe. Dane związane z tą licencją

To pole jest tylko do odczytu i jest wypełniane tylko wtedy, gdy daty rozpoczęcia i zakończenia są ustawione w wywołaniu ListUserListGlobalLicenses.
user_list_id

int64

Niezmienne. Identyfikator listy użytkowników, na którą przyznawana jest licencja.
license_type

UserListGlobalLicenseType

Niezmienne. Typ produktu klienta, na który licencjonowana jest lista użytkowników.
status

UserListLicenseStatus

Opcjonalnie. Stan UserListGlobalLicense – ENABLED lub DISABLED.

UserListGlobalLicenseCustomerInfo

Informacje o kliencie globalnej licencji na listę użytkowników. Zostanie on automatycznie utworzony przez system, gdy klient kupi licencję globalną.

Pola
name

string

Identyfikator. Nazwa zasobu klienta z globalną licencją na listę użytkowników.
user_list_id

int64

Tylko dane wyjściowe. Identyfikator listy użytkowników, na którą przyznawana jest licencja.
user_list_display_name

string

Tylko dane wyjściowe. Nazwa listy użytkowników, na którą przyznawana jest licencja.
license_type

UserListGlobalLicenseType

Tylko dane wyjściowe. Typ produktu klienta, na który licencjonowana jest lista użytkowników.
status

UserListLicenseStatus

Tylko dane wyjściowe. Stan UserListDirectLicense – ENABLED lub DISABLED.
pricing

UserListLicensePricing

Tylko dane wyjściowe. Ceny UserListDirectLicense.
client_account_type

UserListLicenseClientAccountType

Tylko dane wyjściowe. Typ produktu klienta, na który licencjonowana jest lista użytkowników.
client_account_id

int64

Tylko dane wyjściowe. Identyfikator klienta, któremu licencjonowana jest lista użytkowników.
client_account_display_name

string

Tylko dane wyjściowe. Nazwa klienta, któremu licencjonowana jest lista użytkowników.
historical_pricings[]

UserListLicensePricing

Tylko dane wyjściowe. Historia cen licencji na tę listę użytkowników.
metrics

UserListLicenseMetrics

Tylko dane wyjściowe. Dane związane z tą licencją

To pole jest wypełniane tylko wtedy, gdy daty rozpoczęcia i zakończenia są ustawione w wywołaniu ListUserListGlobalLicenseCustomerInfos.

UserListGlobalLicenseType

Typy licencji globalnych na listy użytkowników.

Wartości w polu enum
USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED NIE OKREŚLONO.
USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER Licencja sprzedawcy.
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE Licencja DataMart Sell Side.
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE Licencja DataMart Buy Side.

UserListLicenseClientAccountType

Możliwa usługa na koncie klienta w przypadku licencji na listę użytkowników.

Wartości w polu enum
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN Brak informacji.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS klient Google Ads;
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER partnera Display & Video 360.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER reklamodawcą Display & Video 360;

UserListLicenseMetrics

Dane związane z licencją na listę użytkowników.

Pola
click_count

int64

Tylko dane wyjściowe. Liczba kliknięć w przypadku licencji na listę użytkowników.
impression_count

int64

Tylko dane wyjściowe. Liczba wyświetleń licencji na listę użytkowników.
revenue_usd_micros

int64

Tylko dane wyjściowe. Przychody z licencji na listę użytkowników w milionowych częściach jednostki.
start_date

int64

Tylko dane wyjściowe. Data rozpoczęcia (włącznie) danych w formacie RRRRMMDD. Na przykład 20260102 oznacza 2 stycznia 2026 r. Jeśli w filtrze używana jest właściwość end_date, wymagana jest też właściwość start_date. Jeśli w filtrze nie ma ani start_date, ani end_date, pola UserListLicenseMetrics nie zostaną wypełnione w odpowiedzi.
end_date

int64

Tylko dane wyjściowe. Data zakończenia (włącznie) danych w formacie RRRRMMDD. Na przykład 20260102 oznacza 2 stycznia 2026 r. Jeśli w filtrze używana jest właściwość start_date, wymagana jest też właściwość end_date. Jeśli w filtrze nie ma ani start_date, ani end_date, pola UserListLicenseMetrics nie zostaną wypełnione w odpowiedzi.

UserListLicensePricing

Ceny licencji na listę użytkowników.

Pola
pricing_id

int64

Tylko dane wyjściowe. Identyfikator tego cennika.
start_time

Timestamp

Tylko dane wyjściowe. Czas rozpoczęcia obowiązywania ceny.
end_time

Timestamp

Opcjonalnie. Czas zakończenia obowiązywania ceny.
pricing_active

bool

Tylko dane wyjściowe. Określa, czy te ceny są aktywne.
buyer_approval_state

UserListPricingBuyerApprovalState

Tylko dane wyjściowe. Stan zatwierdzenia tych cen przez kupującego.

To pole jest tylko do odczytu.
cost_micros

int64

Opcjonalnie. Koszt związany z modelem w mikrojednostkach (10^-6) w walucie określonej w polu currency_code. Na przykład 2000000 oznacza 2 PLN, jeśli currency_code to USD.
currency_code

string

Opcjonalnie. Waluta, w której określono koszt i maksymalny koszt. Musi to być trzyliterowy kod waluty zdefiniowany w standardzie ISO 4217.
cost_type

UserListPricingCostType

Niezmienne. Typ kosztów tej ceny.

Można ustawić tylko w operacji create. Nie można go zaktualizować w przypadku istniejącej licencji.
max_cost_micros

int64

Opcjonalnie. Maksymalny CPM, jaki może zostać naliczony w przypadku odbiorców handlowych, gdy używany jest typ kosztu MEDIA_SHARE. Wartość jest podana w mikrojednostkach (10^-6) i w walucie określonej w polu currency_code. Na przykład 2000000 oznacza 2 PLN, jeśli currency_code to USD.

Ma to znaczenie tylko wtedy, gdy cost_type ma wartość MEDIA_SHARE. Jeśli cost_type nie ma wartości MEDIA_SHARE, a to pole jest ustawione, zwracany jest błąd MAX_COST_NOT_ALLOWED. Jeśli zasada jest nieskonfigurowana lub ma wartość 0, nie ma limitu.

UserListPricingBuyerApprovalState

Stan zatwierdzenia przez kupującego cen listy użytkowników.

Wartości w polu enum
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED NIE OKREŚLONO.
PENDING Klient listy użytkowników nie zaakceptował jeszcze warunków cenowych określonych przez właściciela listy użytkowników.
APPROVED Klient listy użytkowników zaakceptował warunki cenowe ustalone przez właściciela listy użytkowników.
REJECTED Klient listy użytkowników odrzucił warunki cenowe ustalone przez właściciela listy użytkowników.

UserListPricingCostType

Typ kosztu ceny listy użytkowników.

Wartości w polu enum
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED Nie określono.
CPC koszt kliknięcia,
CPM Koszt tysiąca wyświetleń.
MEDIA_SHARE Udostępnianie multimediów.

UserListLicenseStatus

Stan licencji listy użytkowników.

Wartości w polu enum
USER_LIST_LICENSE_STATUS_UNSPECIFIED Brak informacji.
USER_LIST_LICENSE_STATUS_ENABLED Stan aktywny – lista użytkowników jest nadal licencjonowana.
USER_LIST_LICENSE_STATUS_DISABLED Stan nieaktywny – lista użytkowników nie jest już licencjonowana.

UserProperties

Informacje o użytkowniku ocenione przez reklamodawcę w momencie wystąpienia zdarzenia. Więcej informacji znajdziesz na stronie https://support.google.com/google-ads/answer/14007601.

Pola
customer_type

CustomerType

Opcjonalnie. Typ klienta powiązanego ze zdarzeniem.
customer_value_bucket

CustomerValueBucket

Opcjonalnie. Wartość klienta określona przez reklamodawcę.
additional_user_properties[]

UserProperty

Opcjonalnie. Zbiór dodatkowych właściwości użytkownika powiązanych z tym zdarzeniem.

UserProperty

Zbiór dodatkowych właściwości użytkownika powiązanych z tym zdarzeniem.

Pola
property_name

string

Wymagane. Nazwa właściwości użytkownika do użycia.
value

string

Wymagane. Ciąg znaków reprezentujący wartość właściwości użytkownika do użycia.

WarningCount

Liczba ostrzeżeń dla danego powodu ostrzeżenia.

Pola
record_count

int64

Liczba rekordów, które zawierają ostrzeżenie.
reason

ProcessingWarningReason

Powód ostrzeżenia.

WarningInfo

Liczba ostrzeżeń dla każdego typu ostrzeżenia.

Pola
warning_counts[]

WarningCount

Lista ostrzeżeń i liczba ostrzeżeń według przyczyny.