Package google.ads.searchads360.v0.services

Indice

CustomColumnService

Servizio per la gestione delle colonne personalizzate.

GetCustomColumn

rpc GetCustomColumn(GetCustomColumnRequest) returns (CustomColumn)

Restituisce la colonna personalizzata richiesta in dettaglio.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc ListCustomColumns(ListCustomColumnsRequest) returns (ListCustomColumnsResponse)

Restituisce tutte le colonne personalizzate associate al cliente in modo dettagliato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

CustomerService

Servizio per la gestione dei clienti.

ListAccessibleCustomers

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse)

Restituisce i nomi delle risorse dei clienti direttamente accessibili dall'utente che autentica la chiamata.

Elenco degli errori generati: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

SearchAds360FieldService

Servizio per recuperare i campi dell'API Search Ads 360.

GetSearchAds360Field

rpc GetSearchAds360Field(GetSearchAds360FieldRequest) returns (SearchAds360Field)

Restituisce solo il campo richiesto.

Elenco degli errori generati: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc SearchSearchAds360Fields(SearchSearchAds360FieldsRequest) returns (SearchSearchAds360FieldsResponse)

Restituisce tutti i campi che corrispondono alla query di ricerca.

Elenco degli errori generati: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

SearchAds360Service

Servizio per il recupero di dati e metriche dalle risorse.

Cerca

rpc Search(SearchSearchAds360Request) returns (SearchSearchAds360Response)

Restituisce tutte le righe che corrispondono alla query di ricerca.

Elenco degli errori generati: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc SearchStream(SearchSearchAds360StreamRequest) returns (SearchSearchAds360StreamResponse)

Restituisce tutte le righe che corrispondono alla query dello stream di ricerca.

Elenco degli errori generati: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

ConversionCustomDimensionHeader

Messaggio per l'intestazione della dimensione personalizzata relativa alle conversioni.

Campi
id

int64

L'ID della dimensione personalizzata di conversione.

name

string

Il nome definito dall'utente della dimensione personalizzata di conversione.

ConversionCustomMetricHeader

Messaggio per l'intestazione della metrica personalizzata di conversione.

Campi
id

int64

L'ID della metrica personalizzata di conversione.

name

string

Il nome definito dall'utente della metrica personalizzata di conversione.

CustomColumnHeader

Messaggio per l'intestazione della colonna personalizzata.

Campi
id

int64

L'ID colonna personalizzata.

name

string

Il nome definito dall'utente della colonna personalizzata.

references_metrics

bool

True se la colonna personalizzata fa riferimento alle metriche.

GetCustomColumnRequest

Richiesta di messaggio per CustomColumnService.GetCustomColumn.

Campi
resource_name

string

Obbligatorio. Il nome della risorsa della colonna personalizzata da recuperare.

GetSearchAds360FieldRequest

Messaggio di richiesta per SearchAds360FieldService.GetSearchAds360Field.

Campi
resource_name

string

Obbligatorio. Il nome della risorsa del campo da recuperare.

ListAccessibleCustomersRequest

Questo tipo non contiene campi.

Richiesta di messaggio per CustomerService.ListAccessibleCustomers.

ListAccessibleCustomersResponse

Messaggio di risposta per CustomerService.ListAccessibleCustomers.

Campi
resource_names[]

string

Nome risorsa dei clienti direttamente accessibile dall'utente che autentica la chiamata.

ListCustomColumnsRequest

Messaggio di richiesta per CustomColumnService.ListCustomColumns

Campi
customer_id

string

Obbligatorio. L'ID del cliente a cui applicare l'operazione dell'elenco CustomColumn.

ListCustomColumnsResponse

Messaggio di risposta per il recupero di tutte le colonne personalizzate associate a un cliente.

Campi
custom_columns[]

CustomColumn

Le colonne personalizzate di proprietà del cliente indicato.

RawEventConversionDimensionHeader

Messaggio per l'intestazione della dimensione di conversione evento non elaborata.

Campi
id

int64

L'ID della variabile personalizzata di conversione.

name

string

Il nome definito dall'utente della dimensione evento non elaborata.

RawEventConversionMetricHeader

Messaggio per l'intestazione della metrica di conversione degli eventi non elaborata.

Campi
id

int64

L'ID variabile personalizzata della conversione.

name

string

Il nome definito dall'utente della metrica evento non elaborata.

Riga Search Ads 360

Una riga restituita dalla query.

Campi
ad_group

AdGroup

Il gruppo di annunci a cui viene fatto riferimento nella query.

ad_group_ad

AdGroupAd

L'annuncio a cui viene fatto riferimento nella query.

ad_group_ad_effective_label

AdGroupAdEffectiveLabel

L'etichetta efficace dell'annuncio del gruppo di annunci a cui si fa riferimento nella query.

ad_group_ad_label

AdGroupAdLabel

L'etichetta dell'annuncio del gruppo di annunci a cui si fa riferimento nella query.

ad_group_asset

AdGroupAsset

L'asset del gruppo di annunci a cui si fa riferimento nella query.

ad_group_asset_set

AdGroupAssetSet

L'insieme di asset del gruppo di annunci a cui viene fatto riferimento nella query.

ad_group_audience_view

AdGroupAudienceView

La visualizzazione del segmento di pubblico del gruppo di annunci a cui si fa riferimento nella query.

ad_group_bid_modifier

AdGroupBidModifier

Il modificatore di offerta a cui si fa riferimento nella query.

ad_group_criterion

AdGroupCriterion

Il criterio a cui viene fatto riferimento nella query.

ad_group_criterion_effective_label

AdGroupCriterionEffectiveLabel

L'etichetta effettiva del criterio del gruppo di annunci a cui viene fatto riferimento nella query.

ad_group_criterion_label

AdGroupCriterionLabel

L'etichetta del criterio del gruppo di annunci a cui si fa riferimento nella query.

ad_group_effective_label

AdGroupEffectiveLabel

L'etichetta del gruppo di annunci effettiva a cui viene fatto riferimento nella query.

ad_group_label

AdGroupLabel

L'etichetta del gruppo di annunci a cui viene fatto riferimento nella query.

age_range_view

AgeRangeView

La vista della fascia d'età a cui fa riferimento la query.

asset

Asset

La risorsa a cui si fa riferimento nella query.

asset_group_asset

AssetGroupAsset

L'asset gruppo di asset a cui si fa riferimento nella query.

asset_group_signal

AssetGroupSignal

L'indicatore del gruppo di asset a cui viene fatto riferimento nella query.

asset_group_listing_group_filter

AssetGroupListingGroupFilter

Il filtro del gruppo di schede del gruppo di asset a cui viene fatto riferimento nella query.

asset_group_top_combination_view

AssetGroupTopCombinationView

La visualizzazione della combinazione migliore del gruppo di asset a cui si fa riferimento nella query.

asset_group

AssetGroup

Il gruppo di asset a cui si fa riferimento nella query.

asset_set_asset

AssetSetAsset

L'asset dell'insieme a cui si fa riferimento nella query.

asset_set

AssetSet

L'insieme di asset a cui si fa riferimento nella query.

bidding_strategy

BiddingStrategy

La strategia di offerta a cui si fa riferimento nella query.

campaign_budget

CampaignBudget

Il budget della campagna a cui viene fatto riferimento nella query.

campaign

Campaign

La campagna a cui si fa riferimento nella query.

campaign_asset

CampaignAsset

L'asset della campagna a cui si fa riferimento nella query.

campaign_asset_set

CampaignAssetSet

Il set di asset della campagna a cui si fa riferimento nella query.

campaign_audience_view

CampaignAudienceView

La visualizzazione del segmento di pubblico della campagna a cui si fa riferimento nella query.

campaign_criterion

CampaignCriterion

Il criterio della campagna a cui si fa riferimento nella query.

campaign_effective_label

CampaignEffectiveLabel

L'etichetta efficace della campagna a cui si fa riferimento nella query.

campaign_label

CampaignLabel

L'etichetta della campagna a cui si fa riferimento nella query.

cart_data_sales_view

CartDataSalesView

La visualizzazione delle vendite dei dati del carrello a cui si fa riferimento nella query.

audience

Audience

Il segmento di pubblico a cui viene fatto riferimento nella query.

conversion_action

ConversionAction

L'azione di conversione a cui viene fatto riferimento nella query.

conversion_custom_variable

ConversionCustomVariable

La variabile personalizzata di conversione a cui si fa riferimento nella query.

customer

Customer

Il cliente indicato nella query.

customer_asset

CustomerAsset

La risorsa cliente a cui si fa riferimento nella query.

customer_asset_set

CustomerAssetSet

L'insieme di asset dei clienti a cui si fa riferimento nella query.

accessible_bidding_strategy

AccessibleBiddingStrategy

La strategia di offerta accessibile a cui si fa riferimento nella query.

customer_client

CustomerClient

Il CustomerClient a cui si fa riferimento nella query.

dynamic_search_ads_search_term_view

DynamicSearchAdsSearchTermView

La visualizzazione dei termini di ricerca degli annunci dinamici della rete di ricerca a cui si fa riferimento nella query.

gender_view

GenderView

La visualizzazione del genere a cui viene fatto riferimento nella query.

geo_target_constant

GeoTargetConstant

La costante del targeting geografico a cui si fa riferimento nella query.

keyword_view

KeywordView

La visualizzazione delle parole chiave a cui si fa riferimento nella query.

label

Label

L'etichetta a cui si fa riferimento nella query.

language_constant

LanguageConstant

La costante linguistica a cui viene fatto riferimento nella query.

location_view

LocationView

La vista della località a cui viene fatto riferimento nella query.

product_bidding_category_constant

ProductBiddingCategoryConstant

La categoria di offerte per i prodotti a cui viene fatto riferimento nella query.

product_group_view

ProductGroupView

La visualizzazione del gruppo di prodotti a cui si fa riferimento nella query.

shopping_performance_view

ShoppingPerformanceView

La visualizzazione del rendimento di Shopping a cui si fa riferimento nella query.

user_list

UserList

L'elenco di utenti a cui viene fatto riferimento nella query.

user_location_view

UserLocationView

La vista della posizione dell'utente a cui si fa riferimento nella query.

webpage_view

WebpageView

La visualizzazione della pagina web a cui si fa riferimento nella query.

visit

Visit

La visita a livello di evento a cui viene fatto riferimento nella query.

conversion

Conversion

La conversione a livello di evento a cui si fa riferimento nella query.

metrics

Metrics

Le metriche.

segments

Segments

I segmenti.

custom_columns[]

Value

Le colonne personalizzate.

SearchSearchAds360FieldsRequest

Richiesta di messaggio per SearchAds360FieldService.SearchSearchAds360Fields.

Campi
query

string

Obbligatorio. La stringa di query.

page_token

string

Token della pagina da recuperare. Se non specificato, verrà restituita la prima pagina di risultati. Utilizza il valore ottenuto da next_page_token nella risposta precedente per richiedere la pagina successiva dei risultati.

page_size

int32

Numero di elementi da recuperare in una singola pagina. Quando viene richiesta una pagina troppo grande, il server può decidere di limitare ulteriormente il numero di risorse restituite.

SearchSearchAds360FieldsResponse

Messaggio di risposta per SearchAds360FieldService.SearchSearchAds360Fields.

Campi
results[]

SearchAds360Field

L'elenco dei campi corrispondenti alla query.

next_page_token

string

Token di paginazione utilizzato per recuperare la pagina di risultati successiva. Trasmetti i contenuti di questa stringa come attributo page_token della prossima richiesta. next_page_token non viene restituito per l'ultima pagina.

total_results_count

int64

Numero totale di risultati corrispondenti alla query ignorando la clausola LIMIT.

SearchSearchAds360Request

Richiesta di messaggio per SearchAds360Service.Search.

Campi
customer_id

string

Obbligatorio. L'ID del cliente a cui viene eseguita la query.

query

string

Obbligatorio. La stringa di query.

page_token

string

Token della pagina da recuperare. Se non specificato, verrà restituita la prima pagina di risultati. Utilizza il valore ottenuto da next_page_token nella risposta precedente per richiedere la pagina successiva dei risultati.

page_size

int32

Numero di elementi da recuperare in una singola pagina. Quando viene richiesta una pagina troppo grande, il server potrebbe decidere di limitare ulteriormente il numero di risorse restituite.

validate_only

bool

Se è true, la richiesta viene convalidata, ma non eseguita.

return_total_results_count

bool

Se true, il numero totale di risultati corrispondenti alla query che ignora la clausola LIMIT verrà incluso nella risposta. Il valore predefinito è false.

summary_row_setting

SummaryRowSetting

Determina se verrà restituita una riga di riepilogo. Per impostazione predefinita, la riga di riepilogo non viene restituita. Se richiesta, la riga di riepilogo verrà inviata in una risposta da sola dopo che sono stati restituiti tutti gli altri risultati della query.

SearchSearchAds360Response

Messaggio di risposta per SearchAds360Service.Search.

Campi
results[]

SearchAds360Row

L'elenco delle righe corrispondenti alla query.

next_page_token

string

Token di paginazione utilizzato per recuperare la pagina di risultati successiva. Trasmetti i contenuti di questa stringa come attributo page_token della prossima richiesta. next_page_token non viene restituito per l'ultima pagina.

total_results_count

int64

Numero totale di risultati corrispondenti alla query ignorando la clausola LIMIT.

field_mask

FieldMask

FieldMask che rappresenta i campi richiesti dall'utente.

summary_row

SearchAds360Row

Riga di riepilogo contenente il riepilogo delle metriche nei risultati. Riepilogo delle metriche significa aggregazione delle metriche in tutti i risultati. Qui l'aggregazione può essere somma, media, percentuale e così via.

custom_column_headers[]

CustomColumnHeader

Le intestazioni delle colonne personalizzate nei risultati.

conversion_custom_metric_headers[]

ConversionCustomMetricHeader

Le intestazioni delle metriche personalizzate sulle conversioni nei risultati.

conversion_custom_dimension_headers[]

ConversionCustomDimensionHeader

Le intestazioni delle dimensioni personalizzate di conversione nei risultati.

raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

Le intestazioni delle metriche non elaborate sulle conversioni degli eventi nei risultati.

raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

Le intestazioni delle dimensioni di conversione degli eventi non elaborati nei risultati.

SearchSearchAds360StreamRequest

Messaggio di richiesta per SearchAds360Service.SearchStream.

Campi
customer_id

string

Obbligatorio. L'ID del cliente a cui viene eseguita la query.

query

string

Obbligatorio. La stringa di query.

batch_size

int32

Il numero di righe restituite in ogni batch di risposta dello stream. Se viene richiesto un batch troppo grande, il server potrebbe decidere di limitare ulteriormente il numero di righe restituite.

summary_row_setting

SummaryRowSetting

Determina se verrà restituita una riga di riepilogo. Per impostazione predefinita, la riga di riepilogo non viene restituita. Se richiesta, la riga di riepilogo verrà inviata in una risposta da sola dopo che sono stati restituiti tutti gli altri risultati della query.

SearchSearchAds360StreamResponse

Messaggio di risposta per SearchAds360Service.SearchStream.

Campi
results[]

SearchAds360Row

L'elenco delle righe corrispondenti alla query.

field_mask

FieldMask

FieldMask che rappresenta i campi richiesti dall'utente.

summary_row

SearchAds360Row

Riga di riepilogo contenente il riepilogo delle metriche nei risultati. Riepilogo delle metriche significa aggregazione delle metriche in tutti i risultati. Qui l'aggregazione può essere somma, media, percentuale e così via.

custom_column_headers[]

CustomColumnHeader

Le intestazioni delle colonne personalizzate nei risultati.

conversion_custom_metric_headers[]

ConversionCustomMetricHeader

Le intestazioni delle metriche personalizzate sulle conversioni nei risultati.

conversion_custom_dimension_headers[]

ConversionCustomDimensionHeader

Le intestazioni della dimensione personalizzata conversione nei risultati.

raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

Le intestazioni delle metriche non elaborate sulle conversioni degli eventi nei risultati.

raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

Le intestazioni delle dimensioni delle conversioni evento non elaborate nei risultati.

request_id

string

L'ID univoco della richiesta utilizzato per il debug.