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)

Hier werden alle benutzerdefinierten Spalten mit Details zum Kunden zurückgegeben.

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 Ressourcennamen von Kunden zurück, auf die der Nutzer, der den Aufruf authentifiziert, direkt zugänglich ist.

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)

Es wird nur das angeforderte Feld zurückgegeben.

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 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

Dieser Wert ist „True“, 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 mit einem Kunden verknüpft sind.

Felder
custom_columns[]

CustomColumn

Die benutzerdefinierten Spalten, die dem angegebenen Kunden gehören.

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 Messwert-Header der Conversion-Rohereignisse.

Felder
id

int64

Die ID der benutzerdefinierten Conversion-Variablen.

name

string

Der benutzerdefinierte Name des Rohereignismesswerts.

SearchAds360Row

Eine von der Abfrage zurückgegebene Zeile.

Felder
ad_group

AdGroup

Die Anzeigengruppe, auf die in der Abfrage verwiesen wird.

ad_group_ad

AdGroupAd

Die in der Abfrage angegebene Anzeige.

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_label

AdGroupCriterionLabel

Das Label des Kriteriums für die Anzeigengruppe, auf das in der Abfrage verwiesen wird

ad_group_effective_label

AdGroupEffectiveLabel

Das effektive Label für die Anzeigengruppe, auf das in der Abfrage verwiesen wird

ad_group_label

AdGroupLabel

Das in der Abfrage angegebene Anzeigengruppenlabel.

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 Asset-Gruppensignal, auf das in der Abfrage verwiesen wird

asset_group_listing_group_filter

AssetGroupListingGroupFilter

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

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 Kampagnenbudget, auf das in der Abfrage verwiesen wird.

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 Asset-Gruppe der Kampagne, auf die in der Abfrage verwiesen wird.

campaign_audience_view

CampaignAudienceView

Die Zielgruppenübersicht 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 in der Abfrage angegebene Label für die Kampagneneffektivität.

campaign_label

CampaignLabel

Das in der Abfrage angegebene Kampagnenlabel.

cart_data_sales_view

CartDataSalesView

Die Datenansicht mit Warenkorbdaten, auf die in der Abfrage verwiesen wird.

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 Produktgruppenansicht, auf die in der Abfrage verwiesen wird

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.

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. 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 begrenzen.

SearchSearchAds360FieldsResponse

Antwortnachricht für SearchAds360FieldService.SearchSearchAds360Fields.

Felder
results[]

SearchAds360Field

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

next_page_token

string

Das Paginierungstoken, das zum Abrufen der nächsten Ergebnisseite verwendet wird. Übergeben Sie den Inhalt dieses Strings als page_token-Attribut der nächsten Anfrage. Für die letzte Seite wird kein next_page_token zurückgegeben.

total_results_count

int64

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

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 begrenzen.

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 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 kein next_page_token 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, die eine Zusammenfassung der Messwerte in den Ergebnissen enthält. „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 Rohereignis-Conversion-Dimensionen 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 Streamantwortbatch 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, die eine Zusammenfassung der Messwerte in den Ergebnissen enthält. „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 Rohdaten zu Ereignis-Conversions in den Ergebnissen.

raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

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

request_id

string

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