Package google.ads.searchads360.v0.services

Indeks

CustomColumnService

Usługa do zarządzania kolumnami niestandardowymi.

GetCustomColumn

rpc GetCustomColumn(GetCustomColumnRequest) returns (CustomColumn)

Zwraca żądaną kolumnę niestandardową ze wszystkimi szczegółami.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/doubleclicksearch
ListCustomColumns

rpc ListCustomColumns(ListCustomColumnsRequest) returns (ListCustomColumnsResponse)

Zwraca wszystkie kolumny niestandardowe powiązane z klientem w pełnej szczegółowości.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

CustomerService

Usługa do zarządzania klientami.

ListAccessibleCustomers

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse)

Zwraca nazwy zasobów klientów, do których użytkownik uwierzytelniający połączenie ma bezpośredni dostęp.

Lista wyrzucanych błędów: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

SearchAds360FieldService

Usługa pobierania pól interfejsu Search Ads 360 API.

GetSearchAds360Field

rpc GetSearchAds360Field(GetSearchAds360FieldRequest) returns (SearchAds360Field)

Zwraca tylko żądane pole.

Lista błędów: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/doubleclicksearch
SearchSearchAds360Fields

rpc SearchSearchAds360Fields(SearchSearchAds360FieldsRequest) returns (SearchSearchAds360FieldsResponse)

Zwraca wszystkie pola, które pasują do zapytania wyszukiwania.

Lista błędów: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

SearchAds360Service

Usługa pobierania danych i wskaźników z różnych zasobów.

Szukaj

rpc Search(SearchSearchAds360Request) returns (SearchSearchAds360Response)

Zwraca wszystkie wiersze pasujące do zapytania wyszukiwania.

Lista błędów: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/doubleclicksearch
SearchStream

rpc SearchStream(SearchSearchAds360StreamRequest) returns (SearchSearchAds360StreamResponse)

Zwraca wszystkie wiersze pasujące do zapytania dotyczącego strumienia wyszukiwania.

Lista błędów: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

ConversionCustomDimensionHeader

Treść nagłówka wymiaru niestandardowego konwersji

Pola
id

int64

Identyfikator wymiaru niestandardowego konwersji.
name

string

Nazwa wymiaru niestandardowego konwersji zdefiniowana przez użytkownika.

ConversionCustomMetricHeader

Treść nagłówka niestandardowych danych o konwersjach

Pola
id

int64

Identyfikator niestandardowych danych konwersji.
name

string

Nazwa niestandardowych danych konwersji zdefiniowana przez użytkownika.

CustomColumnHeader

Komunikat dla nagłówka kolumny niestandardowej.

Pola
id

int64

Identyfikator kolumny niestandardowej.
name

string

Nazwa kolumny niestandardowej zdefiniowana przez użytkownika.
references_metrics

bool

Wartość Prawda, gdy kolumna niestandardowa odwołuje się do danych.

GetCustomColumnRequest

Prośba o wiadomość dotyczącą CustomColumnService.GetCustomColumn.

Pola
resource_name

string

Wymagane. Nazwa zasobu kolumny niestandardowej do pobrania.

GetSearchAds360FieldRequest

Żądanie wiadomości dla SearchAds360FieldService.GetSearchAds360Field.

Pola
resource_name

string

Wymagane. Nazwa zasobu pola do pobrania.

ListAccessibleCustomersRequest

Ten typ nie ma pól.

Żądanie wiadomości dla CustomerService.ListAccessibleCustomers.

ListAccessibleCustomersResponse

Odpowiedź na pytanie „CustomerService.ListAccessibleCustomers”.

Pola
resource_names[]

string

Nazwa zasobu klientów, do której użytkownik uwierzytelnia wywołanie, ma bezpośredni dostęp.

ListCustomColumnsRequest

Prośba o wiadomość dla CustomColumnService.ListCustomColumns

Pola
customer_id

string

Wymagane. Identyfikator klienta, do którego ma zostać zastosowana operacja na liście CustomColumn.

ListCustomColumnsResponse

Odpowiedź na wczytywanie wszystkich kolumn niestandardowych powiązanych z klientem.

Pola
custom_columns[]

CustomColumn

Kolumny niestandardowe należące do podanego klienta.

RawEventConversionDimensionHeader

Treść nagłówka wymiaru konwersji zdarzenia w postaci nieprzetworzonego zdarzenia.

Pola
id

int64

Identyfikator niestandardowej zmiennej konwersji.
name

string

Zdefiniowana przez użytkownika nazwa wymiaru nieprzetworzonego zdarzenia.

RawEventConversionMetricHeader

Treść komunikatu w nagłówku nagłówka danych o konwersji z nieprzetworzonego zdarzenia.

Pola
id

int64

Identyfikator niestandardowej zmiennej konwersji.
name

string

Zdefiniowana przez użytkownika nazwa nieprzetworzonych danych zdarzenia.

SearchAds360Row

Zwrócony wiersz z zapytania.

Pola
ad_group

AdGroup

Grupa reklam, do której odwołuje się zapytanie.
ad_group_ad

AdGroupAd

Reklama, do której odwołuje się zapytanie.
ad_group_ad_effective_label

AdGroupAdEffectiveLabel

Etykieta skuteczności reklamy w grupie reklam, do której odwołuje się zapytanie.
ad_group_ad_label

AdGroupAdLabel

Etykieta reklamy w grupie reklam, do której odwołuje się zapytanie.
ad_group_asset

AdGroupAsset

Komponent grupy reklam, do którego odwołuje się zapytanie.
ad_group_asset_set

AdGroupAssetSet

Zestaw komponentów grupy reklam, do którego odwołuje się zapytanie.
ad_group_audience_view

AdGroupAudienceView

Widok listy odbiorców grupy reklam, do którego odwołuje się zapytanie.
ad_group_bid_modifier

AdGroupBidModifier

Modyfikator stawki, do którego odwołuje się zapytanie.
ad_group_criterion

AdGroupCriterion

Kryterium, do którego odwołuje się zapytanie.
ad_group_criterion_effective_label

AdGroupCriterionEffectiveLabel

Etykieta skuteczności kryterium w grupie reklam, do której odwołuje się zapytanie.
ad_group_criterion_label

AdGroupCriterionLabel

Etykieta kryterium w grupie reklam, do której odwołuje się zapytanie.
ad_group_effective_label

AdGroupEffectiveLabel

Etykieta skuteczności grupy reklam, do której odwołuje się zapytanie.
ad_group_label

AdGroupLabel

Etykieta grupy reklam, do której odwołuje się zapytanie.
age_range_view

AgeRangeView

Widok przedziału wiekowego, na który wskazuje zapytanie.
asset

Asset

Zasób, do którego odwołuje się zapytanie.
asset_group_asset

AssetGroupAsset

Komponent grupy plików, do którego odwołuje się zapytanie.
asset_group_signal

AssetGroupSignal

Sygnał dotyczący grupy plików, na który wskazuje zapytanie.
asset_group_listing_group_filter

AssetGroupListingGroupFilter

Filtr grupy informacji o produktach w grupie plików, do którego odwołuje się zapytanie.
asset_group_top_combination_view

AssetGroupTopCombinationView

Widok najlepszej kombinacji grupy komponentów, do którego odwołuje się zapytanie.
asset_group

AssetGroup

Grupa komponentów, do której odwołuje się zapytanie.
asset_set_asset

AssetSetAsset

Zasób w zbiorze komponentów, do którego odwołuje się zapytanie.
asset_set

AssetSet

zbiór komponentów, do którego odwołuje się zapytanie;
bidding_strategy

BiddingStrategy

Strategia ustalania stawek, do której odwołuje się zapytanie.
campaign_budget

CampaignBudget

Budżet kampanii, do którego odwołuje się zapytanie.
campaign

Campaign

Kampania, do której odwołuje się zapytanie.
campaign_asset

CampaignAsset

Komponent kampanii, do którego odwołuje się zapytanie.
campaign_asset_set

CampaignAssetSet

Zestaw komponentów kampanii, do którego odwołuje się zapytanie.
campaign_audience_view

CampaignAudienceView

Widok listy odbiorców kampanii, na który wskazuje zapytanie.
campaign_criterion

CampaignCriterion

Kryterium kampanii, do którego odwołuje się zapytanie.
campaign_effective_label

CampaignEffectiveLabel

Etykieta skuteczności kampanii, do której odwołuje się zapytanie.
campaign_label

CampaignLabel

Etykieta kampanii, do której odwołuje się zapytanie.
cart_data_sales_view

CartDataSalesView

Widok danych o sprzedaży z danych koszyka, na który wskazuje zapytanie.
audience

Audience

Odbiorcy, do których odnosi się zapytanie.
conversion_action

ConversionAction

Działanie powodujące konwersję, do którego się odwołuje zapytanie.
conversion_custom_variable

ConversionCustomVariable

Niestandardowa zmienna konwersji, do której odwołuje się zapytanie.
customer

Customer

Klient, do którego odnosi się zapytanie.
customer_asset

CustomerAsset

Zasób klienta, do którego odwołuje się zapytanie.
customer_asset_set

CustomerAssetSet

Zbiór komponentów klienta, do którego odwołuje się zapytanie.
accessible_bidding_strategy

AccessibleBiddingStrategy

Dostępna strategia ustalania stawek, do której odwołuje się zapytanie.
customer_client

CustomerClient

Obiekt CustomerClient, do którego odwołuje się zapytanie.
dynamic_search_ads_search_term_view

DynamicSearchAdsSearchTermView

Widok wyszukiwanych haseł w reklamach dynamicznych, do którego odwołuje się zapytanie.
gender_view

GenderView

Widok płci, do którego odwołuje się zapytanie.
geo_target_constant

GeoTargetConstant

Stała obszaru kierowania geograficznego, do której odwołuje się zapytanie.
keyword_view

KeywordView

Widok słowa kluczowego, do którego odwołuje się zapytanie.
label

Label

Etykieta, do której odwołuje się zapytanie.
language_constant

LanguageConstant

stała języka, na którą wskazuje zapytanie;
location_view

LocationView

Widok lokalizacji, do którego odwołuje się zapytanie.
product_bidding_category_constant

ProductBiddingCategoryConstant

Kategoria określania stawek dla produktów, do której odwołuje się zapytanie.
product_group_view

ProductGroupView

Widok grupy produktów, do którego odwołuje się zapytanie.
shopping_performance_view

ShoppingPerformanceView

Widok skuteczności zakupów, do którego odwołuje się zapytanie.
user_list

UserList

Lista użytkowników, do której odwołuje się zapytanie.
user_location_view

UserLocationView

Widok lokalizacji użytkownika, na który wskazuje zapytanie.
webpage_view

WebpageView

Widok strony internetowej, do którego odwołuje się zapytanie.
visit

Visit

Wizyta na poziomie zdarzenia, do której odwołuje się zapytanie.
conversion

Conversion

Konwersja na poziomie zdarzenia, do której odwołuje się zapytanie.
metrics

Metrics

Dane.
segments

Segments

segmenty,
custom_columns[]

Value

Kolumny niestandardowe.

SearchSearchAds360FieldsRequest

Żądanie wiadomości dla SearchAds360FieldService.SearchSearchAds360Fields.

Pola
query

string

Wymagane. Ciąg zapytania.
page_token

string

Token strony do pobrania. Jeśli nie zostanie określony, zwrócona zostanie pierwsza strona wyników. Aby zażądać kolejnej strony wyników, użyj wartości uzyskanej z next_page_token w poprzedniej odpowiedzi.
page_size

int32

Liczba elementów do pobrania na jednej stronie. Jeśli żądana strona jest zbyt duża, serwer może ograniczyć liczbę zwracanych zasobów.

SearchSearchAds360FieldsResponse

Odpowiedź na pytanie „SearchAds360FieldService.SearchSearchAds360Fields”.

Pola
results[]

SearchAds360Field

Lista pól pasujących do zapytania.
next_page_token

string

Token strony służący do pobierania następnej strony wyników. Przekaż zawartość tego ciągu jako atrybut page_token kolejnego żądania. Na ostatniej stronie nie jest zwracana wartość next_page_token.
total_results_count

int64

Łączna liczba wyników pasujących do zapytania, z pominięciem klauzuli LIMIT.

SearchSearchAds360Request

Żądanie wiadomości dla SearchAds360Service.Search.

Pola
customer_id

string

Wymagane. Identyfikator klienta, którego dotyczy zapytanie.
query

string

Wymagane. Ciąg zapytania.
page_token

string

Token strony do pobrania. Jeśli nie zostanie określony, zwrócona zostanie pierwsza strona wyników. Aby zażądać kolejnej strony wyników, użyj wartości uzyskanej z next_page_token w poprzedniej odpowiedzi.
page_size

int32

Liczba elementów do pobrania na jednej stronie. Gdy żądana strona jest zbyt duża, serwer może zdecydować się na dalsze ograniczenie liczby zwracanych zasobów.
validate_only

bool

Jeśli to prawda, żądanie jest sprawdzane, ale nie jest wykonywane.
return_total_results_count

bool

Jeśli wartość to „PRAWDA”, w odpowiedzi zostanie uwzględniona łączna liczba wyników pasujących do zapytania, z pominięciem klauzuli LIMIT. Wartość domyślna to fałsz.
summary_row_setting

SummaryRowSetting

Określa, czy zostanie zwrócony wiersz podsumowania. Domyślnie wiersz podsumowania nie jest zwracany. W razie potrzeby wiersz podsumowania zostanie wysłany w odpowiedzi jako osobny wiersz po zwróceniu wszystkich innych wyników zapytania.

SearchSearchAds360Response

Odpowiedź na pytanie „SearchAds360Service.Search”.

Pola
results[]

SearchAds360Row

Lista wierszy pasujących do zapytania.
next_page_token

string

Token strony służący do pobierania następnej strony wyników. Przekaż zawartość tego ciągu jako atrybut page_token kolejnego żądania. Na ostatniej stronie nie jest zwracana wartość next_page_token.
total_results_count

int64

Łączna liczba wyników pasujących do zapytania, z pominięciem klauzuli LIMIT.
field_mask

FieldMask

FieldMask, który reprezentuje pola, których żądał użytkownik.
summary_row

SearchAds360Row

Wiersz podsumowania, który zawiera podsumowanie danych w wynikach. Podsumowanie danych oznacza ich agregację we wszystkich wynikach. Dane mogą być sumowane, średnikowane, liczone jako wskaźnik itp.
custom_column_headers[]

CustomColumnHeader

Nagłówki kolumn niestandardowych w wynikach.
conversion_custom_metric_headers[]

ConversionCustomMetricHeader

Nagłówki niestandardowych danych o konwersjach w wynikach.
conversion_custom_dimension_headers[]

ConversionCustomDimensionHeader

Nagłówki wymiarów niestandardowych konwersji w wynikach.
raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

Nagłówki nieprzetworzonych danych o konwersjach zdarzeń w wynikach.
raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

Nagłówki nieprzetworzonych wymiarów konwersji zdarzeń w wynikach.

SearchSearchAds360StreamRequest

Prośba o wiadomość dotyczącą SearchAds360Service.SearchStream.

Pola
customer_id

string

Wymagane. Identyfikator klienta, którego dotyczy zapytanie.
query

string

Wymagane. Ciąg zapytania.
batch_size

int32

Liczba wierszy zwracanych w każdej partii odpowiedzi strumienia. Jeśli żądana partia jest zbyt duża, serwer może ograniczyć liczbę zwracanych wierszy.
summary_row_setting

SummaryRowSetting

Określa, czy zostanie zwrócony wiersz podsumowania. Domyślnie wiersz podsumowania nie jest zwracany. W razie potrzeby wiersz podsumowania zostanie wysłany w odpowiedzi jako osobny wiersz po zwróceniu wszystkich innych wyników zapytania.

SearchSearchAds360StreamResponse

Odpowiedź na pytanie „SearchAds360Service.SearchStream”.

Pola
results[]

SearchAds360Row

Lista wierszy pasujących do zapytania.
field_mask

FieldMask

FieldMask, który reprezentuje pola, których żądał użytkownik.
summary_row

SearchAds360Row

Wiersz podsumowania, który zawiera podsumowanie danych w wynikach. Podsumowanie danych oznacza ich agregację we wszystkich wynikach. Dane mogą być sumowane, średnikowane, liczone jako wskaźnik itp.
custom_column_headers[]

CustomColumnHeader

Nagłówki kolumn niestandardowych w wynikach.
conversion_custom_metric_headers[]

ConversionCustomMetricHeader

Nagłówki niestandardowych danych o konwersjach w wynikach.
conversion_custom_dimension_headers[]

ConversionCustomDimensionHeader

Nagłówki niestandardowego wymiaru konwersji w wynikach.
raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

Nagłówki nieprzetworzonych danych o konwersjach zdarzeń w wynikach.
raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

Nagłówki nieprzetworzonych wymiarów konwersji zdarzeń w wynikach.
request_id

string

Unikalny identyfikator żądania używany do debugowania.