Package google.ads.searchads360.v0.services

Index

CustomColumnService

Dienst zum Verwalten benutzerdefinierter Spalten.

GetCustomColumn

rpc GetCustomColumn(GetCustomColumnRequest) returns (CustomColumn)

Gibt die angeforderte benutzerdefinierte Spalte mit allen Details zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc ListCustomColumns(ListCustomColumnsRequest) returns (ListCustomColumnsResponse)

Gibt alle benutzerdefinierten Spalten zurück, die dem Kunden zugeordnet sind, mit allen Details.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

CustomerService

Dienst zur Verwaltung von Kunden.

ListAccessibleCustomers

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse)

Gibt die Ressourcennamen der Kunden zurück, auf die der Nutzer, der den Aufruf authentifiziert, direkt zugreifen kann.

Liste der ausgegebenen Fehler: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

SearchAds360FieldService

Dienst zum Abrufen von Search Ads 360 API-Feldern.

GetSearchAds360Field

rpc GetSearchAds360Field(GetSearchAds360FieldRequest) returns (SearchAds360Field)

Gibt nur das angeforderte Feld zurück.

Liste der ausgegebenen Fehler: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc SearchSearchAds360Fields(SearchSearchAds360FieldsRequest) returns (SearchSearchAds360FieldsResponse)

Gibt alle Felder zurück, die der Suchanfrage entsprechen.

Liste der ausgegebenen Fehler: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

SearchAds360Service

Dienst zum Abrufen von Daten und Messwerten für verschiedene Ressourcen.

Suchen

rpc Search(SearchSearchAds360Request) returns (SearchSearchAds360Response)

Gibt alle Zeilen zurück, die der Suchanfrage entsprechen.

Liste der ausgegebenen Fehler: AuthenticationError, AuthorizationError, ChangeEventError, ChangeStatusError, ClickViewError, HeaderError, InternalError, QueryError, QuotaError, RequestError

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc SearchStream(SearchSearchAds360StreamRequest) returns (SearchSearchAds360StreamResponse)

Gibt alle Zeilen zurück, die der Suchstreamabfrage entsprechen.

Liste der ausgegebenen Fehler: AuthenticationError, AuthorizationError, ChangeEventError, ChangeStatusError, ClickViewError, HeaderError, InternalError, QueryError, QuotaError, RequestError

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

ConversionCustomDimensionHeader

Meldung für die Überschrift der benutzerdefinierten Conversion-Dimension.

Felder
id

int64

Die ID der benutzerdefinierten Conversion-Dimension.

name

string

Der benutzerdefinierte Name der benutzerdefinierten Conversion-Dimension.

ConversionCustomMetricHeader

Meldung für den Header des benutzerdefinierten Conversion-Messwerts.

Felder
id

int64

Die ID des benutzerdefinierten Conversion-Messwerts.

name

string

Der benutzerdefinierte Name des benutzerdefinierten Conversion-Messwerts.

CustomColumnHeader

Nachricht für benutzerdefinierte Spaltenüberschrift.

Felder
id

int64

Die ID der benutzerdefinierten Spalte.

name

string

Der benutzerdefinierte Name der benutzerdefinierten Spalte.

references_metrics

bool

„Wahr“, wenn in der benutzerdefinierten Spalte auf Messwerte verwiesen wird.

GetCustomColumnRequest

Anfragenachricht für CustomColumnService.GetCustomColumn.

Felder
resource_name

string

Erforderlich. Der Ressourcenname der abzurufenden benutzerdefinierten Spalte.

GetSearchAds360FieldRequest

Anfragenachricht für SearchAds360FieldService.GetSearchAds360Field.

Felder
resource_name

string

Erforderlich. Der Ressourcenname des abzurufenden Felds.

ListAccessibleCustomersRequest

Dieser Typ hat keine Felder.

Anfragenachricht für CustomerService.ListAccessibleCustomers.

ListAccessibleCustomersResponse

Antwortnachricht für CustomerService.ListAccessibleCustomers.

Felder
resource_names[]

string

Ressourcenname der Kunden, auf die der Nutzer, der den Aufruf authentifiziert, direkt zugreifen kann.

ListCustomColumnsRequest

Anfragenachricht für CustomColumnService.ListCustomColumns

Felder
customer_id

string

Erforderlich. Die ID des Kunden, auf den der Vorgang für die Liste „Benutzerdefinierte Spalten“ angewendet werden soll.

ListCustomColumnsResponse

Antwortnachricht zum Abrufen aller benutzerdefinierten Spalten, die einem Kunden zugeordnet sind.

Felder
custom_columns[]

CustomColumn

Die CustomColumns, die dem angegebenen Kunden gehören.

RawEventConversionDimensionHeader

Meldung für die Überschrift der Dimension „Conversion-Rohereignis“.

Felder
id

int64

Die ID der benutzerdefinierten Conversion-Variable.

name

string

Der benutzerdefinierte Name der Dimension für Rohereignisse.

RawEventConversionMetricHeader

Meldung für den Header des Messwerts für die Conversion von Rohereignissen.

Felder
id

int64

Die ID der benutzerdefinierten Conversion-Variable.

name

string

Der benutzerdefinierte Name des Messwerts für Rohereignisse.

SearchAds360Row

Eine von der Abfrage zurückgegebene Zeile.

Felder
ad_group

AdGroup

Die Anzeigengruppe, auf die sich die Anfrage bezieht.

ad_group_ad

AdGroupAd

Die in der Anfrage erwähnte Anzeige.

ad_group_ad_effective_label

AdGroupAdEffectiveLabel

Das in der Abfrage referenzierte effektive Label der Anzeigengruppenanzeige.

ad_group_ad_label

AdGroupAdLabel

Das in der Abfrage referenzierte Anzeigenlabel der Anzeigengruppe.

ad_group_asset

AdGroupAsset

Das in der Abfrage referenzierte Asset der Anzeigengruppe.

ad_group_asset_set

AdGroupAssetSet

Die in der Abfrage referenzierte Asset-Sammlung der Anzeigengruppe.

ad_group_audience_view

AdGroupAudienceView

Die in der Abfrage referenzierte Zielgruppenansicht der Anzeigengruppe.

ad_group_bid_modifier

AdGroupBidModifier

Die in der Abfrage referenzierte Gebotsanpassung.

ad_group_criterion

AdGroupCriterion

Das in der Anfrage referenzierte Kriterium.

ad_group_criterion_effective_label

AdGroupCriterionEffectiveLabel

Das in der Abfrage referenzierte effektive Label des Kriteriums für Anzeigengruppen.

ad_group_criterion_label

AdGroupCriterionLabel

Das in der Abfrage referenzierte Label für das Kriterium der Anzeigengruppe.

ad_group_effective_label

AdGroupEffectiveLabel

Das in der Abfrage referenzierte effektive Label der Anzeigengruppe.

ad_group_label

AdGroupLabel

Das in der Abfrage referenzierte Label der Anzeigengruppe.

age_range_view

AgeRangeView

Die in der Abfrage referenzierte Altersgruppenansicht.

asset

Asset

Das in der Anfrage referenzierte Asset.

asset_group_asset

AssetGroupAsset

Das in der Abfrage referenzierte Asset der Asset-Gruppe.

asset_group_signal

AssetGroupSignal

Das in der Abfrage referenzierte Asset-Gruppensignal.

asset_group_listing_group_filter

AssetGroupListingGroupFilter

Der Filter für Asset-Gruppen-Eintragsgruppen, auf den in der Abfrage verwiesen wird.

asset_group_top_combination_view

AssetGroupTopCombinationView

Die in der Abfrage referenzierte Ansicht der Top-Kombinationen der Asset-Gruppe.

asset_group

AssetGroup

Die in der Abfrage referenzierte Asset-Gruppe.

asset_set_asset

AssetSetAsset

Das Asset in der Asset-Sammlung, auf das in der Abfrage verwiesen wird.

asset_set

AssetSet

Die in der Abfrage referenzierte Asset-Sammlung.

bidding_strategy

BiddingStrategy

Die in der Anfrage referenzierte Gebotsstrategie.

campaign_budget

CampaignBudget

Das in der Anfrage angegebene Kampagnenbudget.

campaign

Campaign

Die Kampagne, auf die in der Abfrage verwiesen wird.

campaign_asset

CampaignAsset

Das in der Abfrage referenzierte Kampagnen-Asset.

campaign_asset_set

CampaignAssetSet

Die in der Abfrage referenzierte Asset-Sammlung der Kampagne.

campaign_audience_view

CampaignAudienceView

Die in der Abfrage referenzierte Zielgruppenansicht der Kampagne.

campaign_criterion

CampaignCriterion

Das Kampagnenkriterium, auf das in der Abfrage verwiesen wird.

campaign_effective_label

CampaignEffectiveLabel

Das in der Abfrage referenzierte Label für die effektive Kampagne.

campaign_label

CampaignLabel

Das in der Abfrage referenzierte Kampagnenlabel.

cart_data_sales_view

CartDataSalesView

Die in der Abfrage referenzierte Ansicht für Verkäufe mit Warenkorbdaten.

audience

Audience

Die in der Abfrage referenzierte Zielgruppe.

conversion_action

ConversionAction

Die in der Abfrage referenzierte Conversion-Aktion.

conversion_custom_variable

ConversionCustomVariable

Die benutzerdefinierte Conversion-Variable, auf die in der Abfrage verwiesen wird.

customer

Customer

Der Kunde, auf den sich die Anfrage bezieht.

customer_asset

CustomerAsset

Das in der Anfrage referenzierte Kunden-Asset.

customer_asset_set

CustomerAssetSet

Die in der Abfrage referenzierte Kunden-Asset-Sammlung.

accessible_bidding_strategy

AccessibleBiddingStrategy

Die in der Abfrage referenzierte zugängliche Gebotsstrategie.

customer_client

CustomerClient

Der in der Abfrage referenzierte CustomerClient.

dynamic_search_ads_search_term_view

DynamicSearchAdsSearchTermView

Die in der Abfrage referenzierte Ansicht „Suchbegriff“ für dynamische Suchanzeigen.

gender_view

GenderView

Die in der Abfrage referenzierte Ansicht für das Geschlecht.

geo_target_constant

GeoTargetConstant

Die in der Abfrage referenzierte geografische Zielkonstante.

keyword_view

KeywordView

Die in der Abfrage referenzierte Keyword-Ansicht.

label

Label

Das in der Anfrage referenzierte Label.

language_constant

LanguageConstant

Die in der Abfrage referenzierte Sprachkonstante.

location_view

LocationView

Die in der Abfrage referenzierte Standortansicht.

product_bidding_category_constant

ProductBiddingCategoryConstant

Die in der Anfrage angegebene Gebotskategorie des Produkts.

product_group_view

ProductGroupView

Die in der Anfrage referenzierte Produktgruppenansicht.

shopping_performance_view

ShoppingPerformanceView

Die in der Abfrage referenzierte Ansicht für die Shopping-Leistung.

user_list

UserList

Die in der Abfrage referenzierte Nutzerliste.

user_location_view

UserLocationView

Die in der Abfrage referenzierte Ansicht für Nutzerstandorte.

webpage_view

WebpageView

Die in der Abfrage referenzierte Seitenansicht.

visit

Visit

Der in der Abfrage referenzierte Besuch auf Ereignisebene.

conversion

Conversion

Die in der Anfrage referenzierte Conversion auf Ereignisebene.

metrics

Metrics

Die Messwerte.

segments

Segments

Die Segmente.

custom_columns[]

Value

Die benutzerdefinierten Spalten.

SearchSearchAds360FieldsRequest

Anfragenachricht für SearchAds360FieldService.SearchSearchAds360Fields.

Felder
query

string

Erforderlich. Der Abfragestring.

page_token

string

Token der Seite, die abgerufen werden soll. Wenn nicht angegeben, wird die erste Ergebnisseite zurückgegeben. Verwenden Sie den Wert aus next_page_token in der vorherigen Antwort, um die nächste Ergebnisseite anzufordern.

page_size

int32

Anzahl der Elemente, die auf einer einzelnen Seite abgerufen werden sollen. Wenn eine zu große Seite angefordert wird, kann der Server die Anzahl der zurückgegebenen Ressourcen weiter einschränken.

SearchSearchAds360FieldsResponse

Antwortnachricht für SearchAds360FieldService.SearchSearchAds360Fields.

Felder
results[]

SearchAds360Field

Die Liste der Felder, die der Abfrage entsprechen.

next_page_token

string

Paginierungstoken zum Abrufen der nächsten Ergebnisseite. Übergeben Sie den Inhalt dieses Strings als Attribut page_token der nächsten Anfrage. next_page_token wird für die letzte Seite nicht zurückgegeben.

total_results_count

int64

Gesamtzahl der Ergebnisse, die der Abfrage entsprechen, wobei die LIMIT-Klausel ignoriert wird.

SearchSearchAds360Request

Anfragenachricht für SearchAds360Service.Search.

Felder
customer_id

string

Erforderlich. Die ID des Kunden, der abgefragt wird.

query

string

Erforderlich. Der Abfragestring.

page_token

string

Token der Seite, die abgerufen werden soll. Wenn nicht angegeben, wird die erste Ergebnisseite zurückgegeben. Verwenden Sie den Wert aus next_page_token in der vorherigen Antwort, um die nächste Ergebnisseite anzufordern.

page_size

int32

Anzahl der Elemente, die auf einer einzelnen Seite abgerufen werden sollen. Wenn eine zu große Seite angefordert wird, kann der Server die Anzahl der zurückgegebenen Ressourcen weiter einschränken.

validate_only

bool

Wenn „true“, wird die Anfrage validiert, aber nicht ausgeführt.

return_total_results_count

bool

Wenn „true“, wird die Gesamtzahl der Ergebnisse, die der Abfrage entsprechen, in die Antwort aufgenommen. Die LIMIT-Klausel wird dabei ignoriert. Der Standardwert ist "false".

summary_row_setting

SummaryRowSetting

Gibt an, ob eine Zusammenfassungszeile zurückgegeben wird. Standardmäßig wird keine Zusammenfassungszeile zurückgegeben. Falls angefordert, wird die Zusammenfassungszeile in einer separaten Antwort gesendet, nachdem alle anderen Abfrageergebnisse zurückgegeben wurden.

SearchSearchAds360Response

Antwortnachricht für SearchAds360Service.Search.

Felder
results[]

SearchAds360Row

Die Liste der Zeilen, die der Abfrage entsprechen.

next_page_token

string

Paginierungstoken zum Abrufen der nächsten Ergebnisseite. Übergeben Sie den Inhalt dieses Strings als Attribut page_token der nächsten Anfrage. next_page_token wird für die letzte Seite nicht zurückgegeben.

total_results_count

int64

Gesamtzahl der Ergebnisse, die der Abfrage entsprechen, wobei die LIMIT-Klausel ignoriert wird.

field_mask

FieldMask

FieldMask, die angibt, welche Felder vom Nutzer angefordert wurden.

summary_row

SearchAds360Row

Zusammenfassungszeile mit einer Zusammenfassung der Messwerte in den Ergebnissen. Die Zusammenfassung von Messwerten bedeutet die Aggregation von Messwerten über alle Ergebnisse hinweg. Die Aggregation kann z. B. Summe, Durchschnitt oder Rate sein.

custom_column_headers[]

CustomColumnHeader

Die Überschriften der benutzerdefinierten Spalten in den Ergebnissen.

conversion_custom_metric_headers[]

ConversionCustomMetricHeader

Die Header der benutzerdefinierten Conversion-Messwerte in den Ergebnissen.

conversion_custom_dimension_headers[]

ConversionCustomDimensionHeader

Die Überschriften der benutzerdefinierten Conversion-Dimensionen in den Ergebnissen.

raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

Die Überschriften der Conversion-Messwerte für Rohereignisse in den Ergebnissen.

raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

Die Überschriften der Rohdaten-Conversion-Dimensionen in den Ergebnissen.

SearchSearchAds360StreamRequest

Anfragenachricht für SearchAds360Service.SearchStream.

Felder
customer_id

string

Erforderlich. Die ID des Kunden, der abgefragt wird.

query

string

Erforderlich. Der Abfragestring.

batch_size

int32

Die Anzahl der Zeilen, die in jedem Stream-Antwortbatch zurückgegeben werden. Wenn ein zu großer Batch angefordert wird, kann der Server die Anzahl der zurückgegebenen Zeilen weiter einschränken.

summary_row_setting

SummaryRowSetting

Gibt an, ob eine Zusammenfassungszeile zurückgegeben wird. Standardmäßig wird keine Zusammenfassungszeile zurückgegeben. Falls angefordert, wird die Zusammenfassungszeile in einer separaten Antwort gesendet, nachdem alle anderen Abfrageergebnisse zurückgegeben wurden.

SearchSearchAds360StreamResponse

Antwortnachricht für SearchAds360Service.SearchStream.

Felder
results[]

SearchAds360Row

Die Liste der Zeilen, die der Abfrage entsprechen.

field_mask

FieldMask

FieldMask, die angibt, welche Felder vom Nutzer angefordert wurden.

summary_row

SearchAds360Row

Zusammenfassungszeile mit einer Zusammenfassung der Messwerte in den Ergebnissen. Die Zusammenfassung von Messwerten bedeutet die Aggregation von Messwerten über alle Ergebnisse hinweg. Die Aggregation kann z. B. Summe, Durchschnitt oder Rate sein.

custom_column_headers[]

CustomColumnHeader

Die Überschriften der benutzerdefinierten Spalten in den Ergebnissen.

conversion_custom_metric_headers[]

ConversionCustomMetricHeader

Die Header der benutzerdefinierten Conversion-Messwerte in den Ergebnissen.

conversion_custom_dimension_headers[]

ConversionCustomDimensionHeader

Die Header der benutzerdefinierten Conversion-Dimension in den Ergebnissen.

raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

Die Überschriften der Conversion-Messwerte für Rohereignisse in den Ergebnissen.

raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

Die Überschriften der Rohdaten-Conversion-Dimensionen in den Ergebnissen.

request_id

string

Die eindeutige ID der Anfrage, die zu Debugging-Zwecken verwendet wird.