Package google.ads.searchads360.v0.services

Index

CustomColumnService

Dienst zum Verwalten benutzerdefinierter Spalten.

GetCustomColumn

rpc GetCustomColumn(GetCustomColumnRequest) returns (CustomColumn)

Die angeforderte benutzerdefinierte Spalte in voller Detaillierung.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc ListCustomColumns(ListCustomColumnsRequest) returns (ListCustomColumnsResponse)

Es werden alle benutzerdefinierten Spalten im Detail zurückgegeben, die mit dem Kunden verknüpft sind.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

CustomerService

Dienst zum Verwalten von Kunden

ListAccessibleCustomers

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse)

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

Liste der geworfenen 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 geworfenen 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 mit der Suchanfrage übereinstimmen.

Liste der geworfenen 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 aus verschiedenen Ressourcen.

Suchen

rpc Search(SearchSearchAds360Request) returns (SearchSearchAds360Response)

Gibt alle Zeilen zurück, die mit der Suchanfrage übereinstimmen.

Liste der geworfenen Fehler: AuthenticationError AuthorizationError 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 mit der Suchstreamabfrage übereinstimmen.

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

ConversionCustomDimensionHeader

Text 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

Nachricht für den benutzerdefinierten Messwert-Header für Conversions.

Felder
id

int64

Die ID des benutzerdefinierten Conversion-Messwerts.

name

string

Der benutzerdefinierte Name des benutzerdefinierten Conversion-Messwerts.

CustomColumnHeader

Nachricht für die Überschrift der benutzerdefinierten Spalte.

Felder
id

int64

Die ID der benutzerdefinierten Spalte.

name

string

Der benutzerdefinierte Name der benutzerdefinierten Spalte.

references_metrics

bool

„Wahr“, wenn die benutzerdefinierte Spalte auf Messwerte verweist.

GetCustomColumnRequest

Anfragenachricht für CustomColumnService.GetCustomColumn.

Felder
resource_name

string

Erforderlich. Der Ressourcenname der benutzerdefinierten Spalte, die abgerufen werden soll.

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 von Kunden, auf die der Nutzer, der den Anruf authentifiziert, direkt zugreifen kann.

ListCustomColumnsRequest

Anfragenachricht für CustomColumnService.ListCustomColumns

Felder
customer_id

string

Erforderlich. Die ID des Kunden, auf den der Listenvorgang „CustomColumn“ angewendet werden soll.

ListCustomColumnsResponse

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

Felder
custom_columns[]

CustomColumn

Die CustomColumns des angegebenen Kunden.

RawEventConversionDimensionHeader

Meldung für Conversion-Dimensionen für Rohereignisse

Felder
id

int64

Die ID der benutzerdefinierten Conversion-Variablen.

name

string

Der benutzerdefinierte Name der Rohereignisdimension.

RawEventConversionMetricHeader

Nachricht für den Conversion-Messwert-Header für Rohereignisse.

Felder
id

int64

Die ID der benutzerdefinierten Conversion-Variablen.

name

string

Der benutzerdefinierte Name des Rohereignismesswerts.

SearchAds360Row

Eine zurückgegebene Zeile der Abfrage.

Felder
ad_group

AdGroup

Die Anzeigengruppe, auf die in der Abfrage verwiesen wird.

ad_group_ad

AdGroupAd

Die Anzeige, auf die in der Anfrage verwiesen wird

ad_group_ad_effective_label

AdGroupAdEffectiveLabel

Das Anzeigengruppen-Anzeigeneffektivitäts-Label, auf das in der Abfrage verwiesen wird.

ad_group_ad_label

AdGroupAdLabel

Das Anzeigenlabel der Anzeigengruppe, auf das in der Abfrage verwiesen wird.

ad_group_asset

AdGroupAsset

Das in der Abfrage referenzierte Asset der Anzeigengruppe.

ad_group_asset_set

AdGroupAssetSet

Das in der Abfrage referenzierte Asset-Set der Anzeigengruppe.

ad_group_audience_view

AdGroupAudienceView

Die Zielgruppenübersicht der Anzeigengruppe, auf die in der Abfrage verwiesen wird.

ad_group_bid_modifier

AdGroupBidModifier

Die Gebotsanpassung, auf die in der Abfrage verwiesen wird.

ad_group_criterion

AdGroupCriterion

Das Kriterium, auf das in der Abfrage verwiesen wird.

ad_group_criterion_effective_label

AdGroupCriterionEffectiveLabel

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

ad_group_criterion_label

AdGroupCriterionLabel

Das Label des Anzeigengruppenkriteriums, auf das in der Abfrage verwiesen wird.

ad_group_effective_label

AdGroupEffectiveLabel

Das in der Abfrage angegebene Label der Anzeigengruppe.

ad_group_label

AdGroupLabel

Das Anzeigengruppenlabel, auf das in der Abfrage verwiesen wird

age_range_view

AgeRangeView

Die Altersgruppenansicht, auf die in der Abfrage verwiesen wird.

asset

Asset

Das Asset, auf das in der Abfrage verwiesen wird.

asset_group_asset

AssetGroupAsset

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

asset_group_signal

AssetGroupSignal

Das in der Abfrage angegebene Asset-Gruppensignal.

asset_group_listing_group_filter

AssetGroupListingGroupFilter

Der in der Abfrage referenzierte Filter für Asset-Eintragsgruppen.

asset_group_top_combination_view

AssetGroupTopCombinationView

Die Ansicht „Top-Kombination der Asset-Gruppe“, auf die in der Abfrage verwiesen wird.

asset_group

AssetGroup

Die Asset-Gruppe, auf die in der Abfrage verwiesen wird.

asset_set_asset

AssetSetAsset

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

asset_set

AssetSet

Die Asset-Set, auf die in der Abfrage verwiesen wird.

bidding_strategy

BiddingStrategy

Die in der Abfrage angegebene Gebotsstrategie.

campaign_budget

CampaignBudget

Das in der Abfrage angegebene Kampagnenbudget.

campaign

Campaign

Die Kampagne, auf die in der Abfrage verwiesen wird.

campaign_asset

CampaignAsset

Das Kampagnen-Asset, auf das in der Abfrage verwiesen wird

campaign_asset_set

CampaignAssetSet

Die Asset-Gruppe der Kampagne, auf die in der Abfrage verwiesen wird.

campaign_audience_view

CampaignAudienceView

Die Zielgruppenansicht der Kampagne, auf die in der Abfrage verwiesen wird.

campaign_criterion

CampaignCriterion

Das Kampagnenkriterium, auf das in der Abfrage verwiesen wird

campaign_effective_label

CampaignEffectiveLabel

Das Kampagnen-Effektiv-Label, auf das in der Abfrage verwiesen wird.

campaign_label

CampaignLabel

Das in der Abfrage angegebene Kampagnenlabel.

cart_data_sales_view

CartDataSalesView

Die in der Abfrage referenzierte Verkaufsdatenansicht für Warenkorbdaten.

audience

Audience

Die Zielgruppe, auf die in der Abfrage verwiesen wird.

conversion_action

ConversionAction

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

conversion_custom_variable

ConversionCustomVariable

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

customer

Customer

Der Kunde, auf den in der Anfrage verwiesen wird.

customer_asset

CustomerAsset

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

customer_asset_set

CustomerAssetSet

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

accessible_bidding_strategy

AccessibleBiddingStrategy

Die zugängliche Gebotsstrategie, auf die in der Abfrage verwiesen wird.

customer_client

CustomerClient

Der in der Abfrage referenzierte CustomerClient.

dynamic_search_ads_search_term_view

DynamicSearchAdsSearchTermView

Die Suchbegriffsansicht für dynamische Suchanzeigen, auf die in der Abfrage verwiesen wird.

gender_view

GenderView

Die Geschlechterdatenansicht, auf die in der Abfrage verwiesen wird.

geo_target_constant

GeoTargetConstant

Die in der Abfrage referenzierte geografische Zielkonstante.

keyword_view

KeywordView

Die Keyword-Ansicht, auf die in der Abfrage verwiesen wird.

label

Label

Das Label, auf das in der Abfrage verwiesen wird.

language_constant

LanguageConstant

Die Sprachkonstante, auf die in der Abfrage verwiesen wird.

location_view

LocationView

Die Standortansicht, auf die in der Abfrage verwiesen wird.

product_bidding_category_constant

ProductBiddingCategoryConstant

Die in der Abfrage angegebene Produktgebotskategorie.

product_group_view

ProductGroupView

Die in der Abfrage referenzierte Produktgruppenansicht.

shopping_performance_view

ShoppingPerformanceView

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

user_list

UserList

Die Nutzerliste, auf die in der Abfrage verwiesen wird.

user_location_view

UserLocationView

Die in der Abfrage angegebene Ansicht für den Nutzerstandort.

webpage_view

WebpageView

Die in der Abfrage angegebene Webseitenansicht.

visit

Visit

Der Besuch auf Ereignisebene, auf den in der Abfrage verwiesen wird.

conversion

Conversion

Die Conversion auf Ereignisebene, auf die in der Abfrage verwiesen wird.

metrics

Metrics

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 keine Angabe erfolgt, wird die erste Ergebnisseite zurückgegeben. Verwenden Sie den Wert von 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 mit der Abfrage übereinstimmen.

next_page_token

string

Paginierungstoken, mit dem die nächste Ergebnisseite abgerufen wird. Übergeben Sie den Inhalt dieses Strings als page_token-Attribut der nächsten Anfrage. Für die letzte Seite wird next_page_token nicht zurückgegeben.

total_results_count

int64

Gesamtzahl der Ergebnisse, die mit der Abfrage übereinstimmen, ohne die LIMIT-Klausel zu ignorieren.

SearchSearchAds360Request

Anfragenachricht für SearchAds360Service.Search.

Felder
customer_id

string

Erforderlich. ID des abgefragten Kunden

query

string

Erforderlich. Der Abfragestring.

page_token

string

Token der Seite, die abgerufen werden soll. Wenn keine Angabe erfolgt, wird die erste Ergebnisseite zurückgegeben. Verwenden Sie den Wert von 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 „wahr“ ist, wird die Gesamtzahl der Ergebnisse, die der Abfrage entsprechen, ohne Berücksichtigung der LIMIT-Klausel in die Antwort aufgenommen. Der Standardwert ist "false".

summary_row_setting

SummaryRowSetting

Bestimmt, ob eine Zusammenfassungszeile zurückgegeben wird. Standardmäßig wird keine Zusammenfassungszeile zurückgegeben. Auf Anforderung wird die Zusammenfassungszeile in einer 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, mit dem die nächste Ergebnisseite abgerufen wird. Übergeben Sie den Inhalt dieses Strings als page_token-Attribut der nächsten Anfrage. Für die letzte Seite wird next_page_token nicht zurückgegeben.

total_results_count

int64

Die Gesamtzahl der Ergebnisse, die mit der Abfrage übereinstimmen, ohne Berücksichtigung der LIMIT-Klausel.

field_mask

FieldMask

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

summary_row

SearchAds360Row

Zusammenfassungszeile mit einer Zusammenfassung der Messwerte in den Ergebnissen. „Zusammenfassung von Messwerten“ bedeutet die Aggregation von Messwerten über alle Ergebnisse hinweg. Hier kann die Aggregation beispielsweise „Summe“, „Durchschnitt“ oder „Rate“ sein.

custom_column_headers[]

CustomColumnHeader

Die Überschriften der benutzerdefinierten Spalten in den Ergebnissen.

conversion_custom_metric_headers[]

ConversionCustomMetricHeader

Die Überschriften 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 Rohmesswerte für Conversion-Ereignisse in den Ergebnissen.

raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

Die Überschriften der Dimensionen für Rohdaten-Conversion-Ereignisse in den Ergebnissen.

SearchSearchAds360StreamRequest

Anfragenachricht für SearchAds360Service.SearchStream.

Felder
customer_id

string

Erforderlich. ID des abgefragten Kunden

query

string

Erforderlich. Der Abfragestring.

batch_size

int32

Die Anzahl der Zeilen, die in jedem Stream-Antwort-Batch 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

Bestimmt, ob eine Zusammenfassungszeile zurückgegeben wird. Standardmäßig wird keine Zusammenfassungszeile zurückgegeben. Auf Anfrage wird die Zusammenfassungszeile in einer Antwort gesendet, nachdem alle anderen Abfrageergebnisse zurückgegeben wurden.

SearchSearchAds360StreamResponse

Antwortnachricht für SearchAds360Service.SearchStream.

Felder
results[]

SearchAds360Row

Die Liste der Zeilen, die mit der Abfrage übereinstimmen.

field_mask

FieldMask

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

summary_row

SearchAds360Row

Zusammenfassungszeile mit einer Zusammenfassung der Messwerte in den Ergebnissen. „Zusammenfassung von Messwerten“ bedeutet die Aggregation von Messwerten über alle Ergebnisse hinweg. Hier kann die Aggregation beispielsweise „Summe“, „Durchschnitt“ oder „Rate“ sein.

custom_column_headers[]

CustomColumnHeader

Die Überschriften der benutzerdefinierten Spalten in den Ergebnissen.

conversion_custom_metric_headers[]

ConversionCustomMetricHeader

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

conversion_custom_dimension_headers[]

ConversionCustomDimensionHeader

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

raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

Die Überschriften der Rohmesswerte für Conversion-Ereignisse in den Ergebnissen.

raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

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

request_id

string

Die eindeutige ID der Anfrage, die zum Debugging verwendet wird.