Package google.ads.datamanager.v1

Indeks

• IngestionService (interfejs)
• MarketingDataInsightsService (interfejs)
• PartnerLinkService (interfejs)
• UserListDirectLicenseService (interfejs)
• UserListGlobalLicenseService (interfejs)
• UserListService (interfejs)
• AdIdentifiers (komunikat)
• AddressInfo (komunikat)
• AgeRange (wyliczenie)
• AudienceMember (komunikat)
• AwsWrappedKeyInfo (komunikat)
• AwsWrappedKeyInfo.KeyType (wyliczenie)
• Baseline (komunikat)
• Baseline.Location (komunikat)
• CartData (komunikat)
• Consent (komunikat)
• ConsentStatus (wyliczenie)
• ContactIdInfo (komunikat)
• CreatePartnerLinkRequest (komunikat)
• CreateUserListDirectLicenseRequest (komunikat)
• CreateUserListGlobalLicenseRequest (komunikat)
• CreateUserListRequest (komunikat)
• CustomVariable (komunikat)
• CustomerType (wyliczenie)
• CustomerValueBucket (wyliczenie)
• DataSourceType (wyliczenie)
• DeletePartnerLinkRequest (komunikat)
• DeleteUserListRequest (komunikat)
• Destination (komunikat)
• DeviceInfo (komunikat)
• Encoding (wyliczenie)
• EncryptionInfo (komunikat)
• ErrorCount (komunikat)
• ErrorInfo (komunikat)
• ErrorReason (wyliczenie)
• Event (komunikat)
• EventParameter (komunikat)
• EventSource (wyliczenie)
• ExperimentalField (komunikat)
• GcpWrappedKeyInfo (komunikat)
• GcpWrappedKeyInfo.KeyType (wyliczenie)
• Gender (wyliczenie)
• GetUserListDirectLicenseRequest (komunikat)
• GetUserListGlobalLicenseRequest (komunikat)
• GetUserListRequest (komunikat)
• IngestAudienceMembersRequest (komunikat)
• IngestAudienceMembersResponse (komunikat)
• IngestEventsRequest (komunikat)
• IngestEventsResponse (komunikat)
• IngestedUserListInfo (komunikat)
• IngestedUserListInfo.UploadKeyType (wyliczenie)
• Item (komunikat)
• ItemParameter (komunikat)
• ListUserListDirectLicensesRequest (komunikat)
• ListUserListDirectLicensesResponse (komunikat)
• ListUserListGlobalLicenseCustomerInfosRequest (komunikat)
• ListUserListGlobalLicenseCustomerInfosResponse (komunikat)
• ListUserListGlobalLicensesRequest (komunikat)
• ListUserListGlobalLicensesResponse (komunikat)
• ListUserListsRequest (komunikat)
• ListUserListsResponse (komunikat)
• MatchRateRange (wyliczenie)
• MobileData (komunikat)
• MobileIdInfo (komunikat)
• MobileIdInfo.KeySpace (wyliczenie)
• PairData (komunikat)
• PairIdInfo (komunikat)
• PartnerAudienceInfo (komunikat)
• PartnerAudienceInfo.PartnerAudienceSource (wyliczenie)
• PartnerLink (komunikat)
• PpidData (komunikat)
• ProcessingErrorReason (wyliczenie)
• ProcessingWarningReason (wyliczenie)
• Product (enum) (wycofane)
• ProductAccount (komunikat)
• ProductAccount.AccountType (wyliczenie)
• PseudonymousIdInfo (komunikat)
• PseudonymousIdInfo.SyncStatus (wyliczenie)
• RemoveAudienceMembersRequest (komunikat)
• RemoveAudienceMembersResponse (komunikat)
• RequestStatusPerDestination (komunikat)
• RequestStatusPerDestination.IngestAudienceMembersStatus (komunikat)
• RequestStatusPerDestination.IngestEventsStatus (komunikat)
• RequestStatusPerDestination.IngestMobileDataStatus (komunikat)
• RequestStatusPerDestination.IngestPairDataStatus (komunikat)
• RequestStatusPerDestination.IngestPpidDataStatus (komunikat)
• RequestStatusPerDestination.IngestUserDataStatus (komunikat)
• RequestStatusPerDestination.IngestUserIdDataStatus (komunikat)
• RequestStatusPerDestination.RemoveAudienceMembersStatus (komunikat)
• RequestStatusPerDestination.RemoveMobileDataStatus (komunikat)
• RequestStatusPerDestination.RemovePairDataStatus (komunikat)
• RequestStatusPerDestination.RemovePpidDataStatus (komunikat)
• RequestStatusPerDestination.RemoveUserDataStatus (komunikat)
• RequestStatusPerDestination.RemoveUserIdDataStatus (komunikat)
• RequestStatusPerDestination.RequestStatus (wyliczenie)
• RetrieveInsightsRequest (komunikat)
• RetrieveInsightsResponse (komunikat)
• RetrieveInsightsResponse.MarketingDataInsight (komunikat)
• RetrieveInsightsResponse.MarketingDataInsight.AudienceInsightsDimension (wyliczenie)
• RetrieveInsightsResponse.MarketingDataInsight.MarketingDataInsightsAttribute (komunikat)
• RetrieveRequestStatusRequest (komunikat)
• RetrieveRequestStatusResponse (komunikat)
• SearchPartnerLinksRequest (komunikat)
• SearchPartnerLinksResponse (komunikat)
• SizeInfo (komunikat)
• TargetNetworkInfo (komunikat)
• TermsOfService (komunikat)
• TermsOfServiceStatus (wyliczenie)
• UpdateUserListDirectLicenseRequest (komunikat)
• UpdateUserListGlobalLicenseRequest (komunikat)
• UpdateUserListRequest (komunikat)
• UserData (komunikat)
• UserIdData (komunikat)
• UserIdInfo (komunikat)
• UserIdentifier (komunikat)
• UserList (komunikat)
• UserList.AccessReason (wyliczenie)
• UserList.AccessStatus (wyliczenie)
• UserList.ClosingReason (wyliczenie)
• UserList.MembershipStatus (wyliczenie)
• UserListDirectLicense (komunikat)
• UserListGlobalLicense (komunikat)
• UserListGlobalLicenseCustomerInfo (komunikat)
• UserListGlobalLicenseType (wyliczenie)
• UserListLicenseClientAccountType (wyliczenie)
• UserListLicenseMetrics (komunikat)
• UserListLicensePricing (komunikat)
• UserListLicensePricing.UserListPricingBuyerApprovalState (wyliczenie)
• UserListLicensePricing.UserListPricingCostType (wyliczenie)
• UserListLicenseStatus (wyliczenie)
• UserProperties (komunikat)
• UserProperty (komunikat)
• WarningCount (komunikat)
• WarningInfo (komunikat)

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.

CreatePartnerLink

rpc CreatePartnerLink(CreatePartnerLinkRequest) returns (PartnerLink) Tworzy link partnera dla danego konta. 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

DeletePartnerLink

rpc DeletePartnerLink(DeletePartnerLinkRequest) returns (Empty) Usuwa link partnera do danego konta. 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

SearchPartnerLinks

rpc SearchPartnerLinks(SearchPartnerLinksRequest) returns (SearchPartnerLinksResponse) Wyszukuje wszystkie połączenia partnerów z danym kontem i do niego. 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

UserListDirectLicenseService

Usługa do zarządzania licencjami bezpośrednimi na listy użytkowników. Usuwanie nie jest obsługiwane 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) Wyświetla wszystkie informacje o klientach na potrzeby globalnej licencji 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

ListUserListGlobalLicenses
rpc ListUserListGlobalLicenses(ListUserListGlobalLicensesRequest) returns (ListUserListGlobalLicensesResponse) Wyświetla listę wszystkich globalnych licencji na listy użytkowników należących 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 urządzeniu używanym (jeśli dotyczy) w momencie wejścia na stronę reklamodawcy po interakcji z reklamą.

AddressInfo

Informacje o adresie użytkownika.

Pola
given_name	string Wymagane. Imię użytkownika (pisane 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 adresu użytkownika.

ZakresWieku

Przedziały wiekowe danych demograficznych

Wartości w polu enum
AGE_RANGE_UNSPECIFIED	Nie określono.
AGE_RANGE_UNKNOWN	Brak informacji.
AGE_RANGE_18_24	w wieku 18–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, na którym ma być przeprowadzona operacja.

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. Typ 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.

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 podstawowa 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 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 produktów, 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.

Zgoda

Ustawienia dotyczące 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 w przypadku list użytkowników kierowania na listę klientów.
data_source_type	DataSourceType Opcjonalnie. Niezmienna. Ź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}
partner_link	PartnerLink Wymagane. Link partnera do utworzenia.

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 bezpośrednio licencjonowana do tworzenia.

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. Licencja globalna 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.

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 kredytowego.
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.

Tę metodę możesz wypróbować 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 DeleteUserList.

Tę metodę możesz wypróbować 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. Służy do odwoływania się do tego zasobu 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 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.

Kodowanie

Typ kodowania zaszyfrowanych informacji identyfikacyjnych.

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

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. Może nie być wypełniony we wszystkich przypadkach.

ErrorReason

Przyczyny błędów w interfejsie Data Manager API. UWAGA: ten wyliczeniowy typ danych nie jest zamrożony i w przyszłości mogą zostać dodane do niego 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	Kod kraju jest nieprawidłowy.
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 członek listy odbiorców 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ć wielu typów danych.
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.
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 miejsca docelowe Google Analytics;
FIELD_VALUE_TOO_LONG	Wartość pola jest za długa.
TOO_MANY_ELEMENTS	Żądanie zawiera zbyt wiele 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 jest zgodny z rzeczywistym typem 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 z branży handlowej mogą być licencjonowane 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 już modyfikować.
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 znajdować się na liście 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	List użytkowników kierowania na listę 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 w przypadku 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 przesłanej liście użytkowników nie jest obsługiwana.
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE	Te typy kont nie są obsługiwane w przypadku tego typu listy użytkowników.
UNSUPPORTED_ACCOUNT_TYPE_FOR_PARTNER_LINK	Te typy kont nie są obsługiwane w przypadku połączenia z partnerem.

Zdarzenie

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

Pola
destination_references[]	string Opcjonalnie. Ciąg znaków 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 konwersji korzystających z wielu źródeł danych.
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, aplikacji, sklepie stacjonarnym itp.).
event_device_info	DeviceInfo Opcjonalnie. Informacje zebrane o urządzeniu używanym (jeśli dotyczy) 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ą 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 internetowych 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.
conversion_value	double Opcjonalnie. Wartość konwersji powiązana ze zdarzeniem w przypadku konwersji opartych na wartości.

EventParameter

Parametr zdarzenia dla 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.
OTHER	Wydarzenie zostało wygenerowane z innych źródeł.

ExperimentalField

Pole eksperymentalne 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 demograficznej (np. kobieta).

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

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.

Tę metodę możesz wypróbować 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 identyfikatorów użytkowników z wartością hash jest to typ kodowania zewnętrznego zaszyfrowanego ciągu znaków, ale niekoniecznie wewnętrznego ciągu znaków z wartością hash. Oznacza to, że wewnętrzny ciąg znaków z wartością hash 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.

Tę metodę możesz wypróbować 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 identyfikatorów użytkowników z wartością hash jest to typ kodowania zewnętrznego zaszyfrowanego ciągu znaków, ale niekoniecznie wewnętrznego ciągu znaków z wartością hash. Oznacza to, że wewnętrzny ciąg znaków z wartością hash 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łnianą danymi przekazywanymi przez użytkowników.

Pola
upload_key_types[]	UploadKeyType Wymagane. Niezmienna. 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

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.

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.

Tę metodę możesz wypróbować w narzędziu do eksplorowania interfejsów API REST:

Wypróbuj z REST

Pola
parent	string Wymagane. Konto, którego licencji dotyczy zapytanie. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
filter	string Opcjonalnie. Filtry do zastosowania w przypadku żądania listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. user_list_id = 123). 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ą przekształcone w 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 globalną licencją.

Tę metodę możesz wypróbować 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 użytkownika znakiem „-” (np. accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).
filter	string Opcjonalnie. Filtry do zastosowania w przypadku żądania listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. user_list_id = 123). 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ą przekształcone w 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 licencji dotyczy zapytanie. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
filter	string Opcjonalnie. Filtry do zastosowania w przypadku żądania listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. user_list_id = 123). 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ą przekształcone w 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ść z prośbą o wywołanie 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 podana, zwracanych będzie co najwyżej 50 list użytkowników. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną przekształcone w 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"). 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	Zakres współczynnika dopasowania wynosi 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	Zakres współczynnika dopasowania wynosi 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 urządzenia mobilnego.

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. Niezmienna. Źródło przesyłanych danych.
key_space	KeySpace Wymagane. Niezmienna. Przestrzeń kluczy identyfikatorów mobilnych.
app_id	string Wymagane. Niezmienna. 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 usługę 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
match_rate_percentage	int32 Tylko dane wyjściowe. To pole oznacza odsetek dopasowania członkostwa na tej liście użytkowników do odpowiednich danych własnych wydawcy. Musi mieścić się w zakresie od 0 do 100 włącznie.
advertiser_identifier_count	int64 Tylko dane wyjściowe. 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.
publisher_id	int64 Wymagane. Niezmienna. Określa wydawcę, z którym dopasowywana jest lista odbiorcó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 cleanroom.
publisher_name	string Opcjonalnie. Opisowa nazwa wydawcy, która będzie wyświetlana w interfejsie, aby zapewnić lepsze kierowanie.
clean_room_identifier	string Wymagane. Niezmienna. Identyfikuje unikalną relację między reklamodawcą a wydawcą w przypadku jednego lub wielu dostawców 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. Niezmienna. Ź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ą odbiorcy agencji lub dostawcy.

PartnerLink

Połączenie partnerskie między kontem będącym właścicielem a kontem partnera.

Pola
name	string Identyfikator. Nazwa linku partnerskiego. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}
partner_link_id	string Tylko dane wyjściowe. Identyfikator linku partnera.
owning_account	ProductAccount Wymagane. Konto, które jest właścicielem konta partnera i przyznaje mu dostęp.
partner_account	ProductAccount Wymagane. Konto partnera, któremu konto będące właścicielem przyznało dostęp.

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.

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_DENIED_CONSENT	Użytkownik lub domyślne ustawienia reklamodawcy odrzucają dane użytkownika na potrzeby reklam.
PROCESSING_ERROR_REASON_NO_CONSENT	Reklamodawca nie wyraził zgody na korzystanie z usług podstawowych platformy reklamowej.
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT	Nie udało się określić ogólnej zgody (na podstawie zgody na poziomie wiersza, zgody na poziomie żądania i ustawień konta) w przypadku tego użytkownika.
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 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 progu minimalnego.
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.

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

Ten element został wycofany.

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 Ten element został wycofany. 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. Wymagana jest właściwość account_type lub wycofana właściwość 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.
GOOGLE_AD_MANAGER_AUDIENCE_LINK	Połączenie z listą odbiorców Google Ad Managera.

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. Niezmienna. 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.

Tę metodę możesz wypróbować 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 prośby o miejsce docelowe.
error_info	ErrorInfo Informacje o błędzie zawierające przyczynę błędu i liczbę błędów związanych z przesyłaniem.
warning_info	WarningInfo Informacje ostrzegawcze zawierające powód ostrzeżenia i liczbę ostrzeżeń związanych z przesłanym plikiem.
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 członkach listy odbiorców.
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.

IngestAudienceMembersStatus

Stan żądania dotyczącego przesyłania danych o członkach listy odbiorców.

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 przesyłania danych użytkownika do miejsca docelowego.
mobile_data_ingestion_status	IngestMobileDataStatus Stan przesyłania 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.

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 przesyłania danych mobilnych do miejsca docelowego zawierającego statystyki związane z przesyłaniem.

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 oni prawidłowo 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 przesyłania danych par do miejsca docelowego zawierającego statystyki związane z przesyłaniem.

Pola
record_count	int64 Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni prawidłowo 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 przesyłania danych PPID do miejsca docelowego zawierającego statystyki związane z tym procesem.

Pola
record_count	int64 Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni prawidłowo 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 przesyłania danych użytkownika do miejsca docelowego zawierającego statystyki związane z przesyłaniem.

Pola
record_count	int64 Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni prawidłowo 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 przesyłania danych identyfikatora użytkownika do miejsca docelowego zawierającego statystyki związane z przesyłaniem.

Pola
record_count	int64 Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni prawidłowo 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 one 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 usuwania 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 usunięcia danych ppid z miejsca docelowego.

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 członków grupy odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci.
mobile_id_count	int64 Łączna liczba identyfikatorów mobilnych przesł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 członków grupy odbiorców w żądaniu, niezależnie od tego, czy zostali oni 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 usunięcia 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 członków grupy odbiorców w żądaniu, niezależnie od tego, czy zostali oni 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 usuwania 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 członków grupy odbiorców w żądaniu, niezależnie od tego, czy zostali oni 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 członków grupy odbiorców w żądaniu, niezależnie od tego, czy zostali oni 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	Żądanie zostało zrealizowane.
PROCESSING	Żądanie jest przetwarzane.
FAILED	Żądanie nie zostało przetworzone.
PARTIAL_SUCCESS	Żądanie zostało częściowo zrealizowane.

RetrieveInsightsRequest

Wiadomość z prośbą o wywołanie funkcji 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 wysyłana jest prośba o 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 odbiorcy uzyskali 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 określono inaczej, 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). 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" OR partner_account.account_id = 987654321

SearchPartnerLinksResponse

Odpowiedź z SearchPartnerLinksRequest.

Pola
partner_links[]	PartnerLink Linki partnera do danego 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.

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 tej listy użytkowników w domenie google.com. Są to elementy dostępne do kierowania w kampaniach w sieci wyszukiwania.

TargetNetworkInfo

Informacje o kwalifikowaniu się do 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.
eligible_for_search	bool Opcjonalnie. Wskazuje, czy ta lista użytkowników kwalifikuje się do korzystania z sieci wyszukiwania 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 usługi 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 kierowania na listę klientów partnera.

TermsOfServiceStatus

Określa decyzję rozmówcy o zaakceptowaniu lub odrzuceniu warunków 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.

Tę metodę możesz wypróbować 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.

Tę metodę możesz wypróbować 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.

Tę metodę możesz wypróbować 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óra ma zostać zaktualizowana. 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 identyfikujące 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 pliku 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. Niezmienna. Źródło przesyłanych danych.

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 kwalifikowaniu się do 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 Niezmienna. Identyfikator listy użytkowników, na którą przyznawana jest licencja.
client_account_type	UserListLicenseClientAccountType Niezmienna. Typ konta klienta, na które licencjonowana jest lista użytkowników.
client_account_id	int64 Niezmienna. 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 Niezmienna. Identyfikator listy użytkowników, na którą przyznawana jest licencja.
license_type	UserListGlobalLicenseType Niezmienna. Typ usługi klienta, do której licencjonowana jest lista użytkowników.
status	UserListLicenseStatus Opcjonalnie. Stan UserListGlobalLicense – WŁĄCZONA lub WYŁĄCZONA.

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 usługi klienta, do której 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 usługi klienta, do której 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	NIEOKREŚLONE.
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;
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK	Połączenie z listą odbiorców Google Ad Managera.

UserListLicenseMetrics

Wskaźniki 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 Niezmienna. 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 z list partneró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	NIEOKREŚLONE.
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ń z danego powodu.

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.