Package google.ads.searchads360.v0.services

Indeks

CustomColumnService

Usługa do zarządzania kolumnami niestandardowymi.

GetCustomColumn

rpc GetCustomColumn(GetCustomColumnRequest) returns (CustomColumn)

Wyświetla szczegóły żądanej kolumny niestandardowej.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc ListCustomColumns(ListCustomColumnsRequest) returns (ListCustomColumnsResponse)

Zwraca pełne szczegóły wszystkie kolumny niestandardowe powiązane z klientem.

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 ma bezpośredni dostęp użytkownik uwierzytelniający połączenie.

Lista zgłoszonych 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 zgłoszonych 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 pasujące do zapytania query.

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

SearchAds360Service

Usługa do pobierania danych i wskaźników z zasobów.

Wyszukiwarka

rpc Search(SearchSearchAds360Request) returns (SearchSearchAds360Response)

Zwraca wszystkie wiersze pasujące do wyszukiwanego hasła.

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
SearchStream

rpc SearchStream(SearchSearchAds360StreamRequest) returns (SearchSearchAds360StreamResponse)

Zwraca wszystkie wiersze pasujące do zapytania w strumieniu 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

Komunikat w nagłówku wymiaru niestandardowego konwersji.

Pola
id

int64

Identyfikator niestandardowego wymiaru konwersji.

name

string

Zdefiniowana przez użytkownika nazwa niestandardowego wymiaru konwersji.

ConversionCustomMetricHeader

Komunikat nagłówka niestandardowych danych konwersji.

Pola
id

int64

Identyfikator niestandardowych danych konwersji.

name

string

Zdefiniowana przez użytkownika nazwa niestandardowych danych konwersji.

CustomColumnHeader

Komunikat nagłówka kolumny niestandardowej.

Pola
id

int64

Identyfikator kolumny niestandardowej.

name

string

Zdefiniowana przez użytkownika nazwa kolumny niestandardowej.

references_metrics

bool

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

GetCustomColumnRequest

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

Pola
resource_name

string

Wymagane. Nazwa zasobu kolumny niestandardowej do pobrania.

GetSearchAds360FieldRequest

Prośba o wiadomość dotyczącą grupy SearchAds360FieldService.GetSearchAds360Field.

Pola
resource_name

string

Wymagane. Nazwa zasobu pola do pobrania.

ListAccessibleCustomersRequest

Ten typ nie ma żadnych pól.

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

ListAccessibleCustomersResponse

Odpowiedź na pytanie: CustomerService.ListAccessibleCustomers.

Pola
resource_names[]

string

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

ListCustomColumnsRequest

Prośba o wiadomość dotyczącą grupy CustomColumnService.ListCustomColumns

Pola
customer_id

string

Wymagane. Identyfikator klienta, do którego chcesz zastosować operację listy niestandardowej kolumny.

ListCustomColumnsResponse

Odpowiedź na żądanie pobrania wszystkich kolumn niestandardowych powiązanych z klientem.

Pola
custom_columns[]

CustomColumn

Kolumny niestandardowe należące do podanego klienta.

RawEventConversionDimensionHeader

Komunikat nagłówka nieprzetworzonego wymiaru konwersji zdarzenia.

Pola
id

int64

Identyfikator niestandardowej zmiennej konwersji.

name

string

Zdefiniowana przez użytkownika nazwa nieprzetworzonego wymiaru zdarzenia.

RawEventConversionMetricHeader

Komunikat nagłówka nieprzetworzonego wskaźnika konwersji zdarzenia.

Pola
id

int64

Identyfikator niestandardowej zmiennej konwersji.

name

string

Zdefiniowana przez użytkownika nazwa nieprzetworzonych danych o zdarzeniach.

Wiersz SearchAds360

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 odwołuje się zapytanie.

ad_group_ad_label

AdGroupAdLabel

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

ad_group_asset

AdGroupAsset

Komponent z grupą 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 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 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

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

asset_group_signal

AssetGroupSignal

Sygnał grupy plików, do którego odwołuje się 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 najpopularniejszej kombinacji grupy plików, do której odwołuje się zapytanie.

asset_group

AssetGroup

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

asset_set_asset

AssetSetAsset

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

asset_set

AssetSet

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

CampaignLabel

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

cart_data_sales_view

CartDataSalesView

Widok sprzedaży danych koszyka, do którego odwołuje się zapytanie.

audience

Audience

Lista odbiorców wymieniona w zapytaniu.

conversion_action

ConversionAction

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

conversion_custom_variable

ConversionCustomVariable

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

customer

Customer

Klient wskazany w zapytaniu.

customer_asset

CustomerAsset

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

customer_asset_set

CustomerAssetSet

Zestaw 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

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

dynamic_search_ads_search_term_view

DynamicSearchAdsSearchTermView

Widok wyszukiwanych haseł w dynamicznych reklamach w wyszukiwarce, 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 celu geograficznego, do którego odwołuje się zapytanie.

keyword_view

KeywordView

Widok słów kluczowych, 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 określania stawek za produkt, 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

Prośba o wiadomość dotyczącą grupy SearchAds360FieldService.SearchSearchAds360Fields.

Pola
query

string

Wymagane. Ciąg zapytania.

page_token

string

Token strony do pobrania. Jeśli nie podasz żadnej wartości, wyświetlana będzie pierwsza strona wyników. Użyj wartości uzyskanej z funkcji next_page_token w poprzedniej odpowiedzi, aby zażądać następnej strony wyników.

page_size

int32

Liczba elementów do pobrania w ramach jednej strony. W przypadku żądania zbyt dużej strony serwer może zdecydować się na dalsze ograniczenie liczby zwracanych zasobów.

SearchSearchAds360FieldsResponse

Odpowiedź na pytanie: SearchAds360FieldService.SearchSearchAds360Fields.

Pola
results[]

SearchAds360Field

Lista pól pasujących do zapytania.

next_page_token

string

Token podziału na strony używany do pobierania następnej strony wyników. Przekaż zawartość tego ciągu jako atrybut page_token w następnym żądaniu. dla ostatniej strony nie zwracany jest next_page_token.

total_results_count

int64

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

SearchSearchAds360Request

Prośba o wiadomość dotyczącą grupy 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 podasz żadnej wartości, wyświetlana będzie pierwsza strona wyników. Użyj wartości uzyskanej z funkcji next_page_token w poprzedniej odpowiedzi, aby zażądać następnej strony wyników.

page_size

int32

Liczba elementów do pobrania w ramach jednej strony. W przypadku żądania zbyt dużej strony serwer może zdecydować się na dalsze ograniczenie liczby 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 ma wartość true (prawda), w odpowiedzi zostanie uwzględniona łączna liczba wyników pasujących do zapytania z pominięciem klauzuli LIMIT. Wartość domyślna to false (fałsz).

summary_row_setting

SummaryRowSetting

Określa, czy wiersz podsumowania zostanie zwrócony. Domyślnie wiersz podsumowania nie jest zwracany. Na żądanie wiersz podsumowania zostanie wysłany w odpowiedzi 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 podziału na strony używany do pobierania następnej strony wyników. Przekaż zawartość tego ciągu jako atrybut page_token w następnym żądaniu. dla ostatniej strony nie zwracany jest next_page_token.

total_results_count

int64

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

field_mask

FieldMask

Maska FieldMask określająca pola, których zażądał użytkownik.

summary_row

SearchAds360Row

Wiersz podsumowania zawierający podsumowanie danych w wynikach. Podsumowanie danych oznacza agregację danych ze wszystkich wyników. W tym przypadku agregacja może mieć postać sumę, średnią, współczynnik 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 niestandardowych wymiarów konwersji w wynikach wyszukiwania.

raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

Nagłówki nieprzetworzonych danych o konwersjach zdarzenia w wynikach.

raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

Nagłówki nieprzetworzonych wymiarów konwersji zdarzenia w wynikach.

SearchSearchAds360StreamRequest

Prośba o wiadomość dotyczącą grupy 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. W przypadku żądania zbyt dużego wsadu serwer może zdecydować się na dalsze ograniczenie liczby zwracanych wierszy.

summary_row_setting

SummaryRowSetting

Określa, czy wiersz podsumowania zostanie zwrócony. Domyślnie wiersz podsumowania nie jest zwracany. Na żądanie wiersz podsumowania zostanie wysłany w odpowiedzi 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

Maska FieldMask określająca pola, których zażądał użytkownik.

summary_row

SearchAds360Row

Wiersz podsumowania zawierający podsumowanie danych w wynikach. Podsumowanie danych oznacza agregację danych ze wszystkich wyników. W tym przypadku agregacja może mieć postać sumę, średnią, współczynnik 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 wyszukiwania.

raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

Nagłówki nieprzetworzonych danych o konwersjach zdarzenia w wynikach.

raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

Nagłówki nieprzetworzonych wymiarów konwersji zdarzenia w wynikach.

request_id

string

Unikalny identyfikator żądania, który jest używany do debugowania.