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 ze wszystkimi szczegółami.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

CustomerService

Usługa 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 wyrzucanych 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 wyrzucanych 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 wyrzucanych 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 zgłoszonych 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

Zdefiniowana przez użytkownika nazwa wymiaru niestandardowego konwersji.

ConversionCustomMetricHeader

Treść nagłówka niestandardowych danych o konwersjach

Pola
id

int64

Identyfikator niestandardowych danych konwersji.

name

string

Nazwa zdefiniowana przez użytkownika dla niestandardowych danych konwersji.

CustomColumnHeader

Komunikat dla nagłówka kolumny niestandardowej.

Pola
id

int64

Identyfikator kolumny niestandardowej.

name

string

Zdefiniowana przez użytkownika nazwa kolumny niestandardowej.

references_metrics

bool

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

GetCustomColumnRequest

Żądanie wiadomości dla 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, które chcesz pobrać.

ListAccessibleCustomersRequest

Ten typ nie ma pól.

Prośba o wiadomość dotyczącą CustomerService.ListAccessibleCustomers.

ListAccessibleCustomersResponse

Wiadomość z odpowiedzią dotyczącą CustomerService.ListAccessibleCustomers.

Pola
resource_names[]

string

Nazwa zasobu klientów, do której użytkownik uwierzytelniający 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 listy CustomColumn.

ListCustomColumnsResponse

Komunikat z odpowiedzią na pobranie wszystkich kolumn niestandardowych powiązanych z klientem.

Pola
custom_columns[]

CustomColumn

Kolumny niestandardowe należące do podanego klienta.

RawEventConversionDimensionHeader

Komunikat dotyczący nagłówka wymiaru konwersji zdarzenia w postaci nieprzetworzonej.

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 zdarzenia w postaci nieprzetworzonej.

Pola
id

int64

Identyfikator zmiennej niestandardowej konwersji.

name

string

Zdefiniowana przez użytkownika nazwa nieprzetworzonych danych zdarzenia.

Wiersz SearchAds 360

Wiersz zwrócony z zapytania.

Pola
ad_group

AdGroup

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

ad_group_ad

AdGroupAd

Reklama, do której odnosi 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órej odwołuje się zapytanie.

ad_group_bid_modifier

AdGroupBidModifier

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

ad_group_criterion

AdGroupCriterion

Kryterium, do którego 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 efektywnej 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, do którego odwołuje się zapytanie.

asset

Asset

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

asset_group_asset

AssetGroupAsset

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

asset_group_signal

AssetGroupSignal

Sygnał dotyczący grupy komponentó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 odbiorców na poziomie kampanii, do którego odwołuje się 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, do którego odwołuje się 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 wskazany w zapytaniu.

customer_asset

CustomerAsset

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

customer_asset_set

CustomerAssetSet

Zbiór zasobó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

Klient 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 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, do której odwołuje się zapytanie.

location_view

LocationView

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

product_bidding_category_constant

ProductBiddingCategoryConstant

Kategoria ustalania stawek produktu, 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.

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 określono tego ustawienia, zostanie zwrócona pierwsza strona wyników. Aby zażądać następnej strony wyników, użyj wartości uzyskanej z next_page_token w poprzedniej odpowiedzi.

page_size

int32

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

SearchSearchAds360FieldsResponse

Wiadomość z odpowiedzią dotyczącą SearchAds360FieldService.SearchSearchAds360Fields.

Pola
results[]

SearchAds360Field

Lista pól, które pasują do zapytania.

next_page_token

string

Token strony do pobierania następnej strony wyników. Przekaż zawartość tego ciągu znaków jako atrybut page_token następnego żądania. Parametr next_page_token nie jest zwracany dla ostatniej strony.

total_results_count

int64

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

SearchSearchAds360Request

Prośba o wiadomość dotyczącą 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 określono tego ustawienia, zostanie zwrócona pierwsza strona wyników. Aby zażądać następnej 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. Po zażądaniu zbyt dużej strony serwer może jeszcze bardziej ograniczyć liczbę zwracanych zasobów.

validate_only

bool

Jeśli ma wartość true (prawda), żądanie jest weryfikowane, ale nie jest wykonywane.

return_total_results_count

bool

Jeśli zasada ma wartość prawda, w odpowiedzi zostanie uwzględniona łączna liczba wyników pasujących do zapytania z ignorowaniem klauzuli LIMIT. Wartość domyślna to false (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

Wiadomość z odpowiedzią dotyczącą SearchAds360Service.Search.

Pola
results[]

SearchAds360Row

Lista wierszy pasujących do zapytania.

next_page_token

string

Token strony do pobierania następnej strony wyników. Przekaż zawartość tego ciągu znaków jako atrybut page_token następnego żą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

Maska pola reprezentująca pola, których zażądał użytkownik.

summary_row

SearchAds360Row

Wiersz podsumowania zawierający 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 konwersji zdarzeń w wynikach.

raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

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

SearchSearchAds360StreamRequest

Żądanie wiadomości dla 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 grupie 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 samodzielnie po zwróceniu wszystkich wyników zapytania.

SearchSearchAds360StreamResponse

Wiadomość z odpowiedzią dotyczącą SearchAds360Service.SearchStream.

Pola
results[]

SearchAds360Row

Lista wierszy pasujących do zapytania.

field_mask

FieldMask

Maska pola reprezentująca pola, których zażądał użytkownik.

summary_row

SearchAds360Row

Wiersz podsumowania zawierający 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 konwersji 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 na potrzeby debugowania.