La nuova API Search Ads 360 Reporting è ora disponibile. Unisciti al gruppo Google searchads-api-announcements per non perderti i prossimi miglioramenti e release.

Questa pagina è stata tradotta dall'API Cloud Translation.

Package google.ads.searchads360.v0.services

Indice

CustomColumnService (interfaccia)
CustomerService (interfaccia)
SearchAds360FieldService (interfaccia)
SearchAds360Service (interfaccia)
ConversionCustomDimensionHeader (messaggio)
ConversionCustomMetricHeader (messaggio)
CustomColumnHeader (messaggio)
GetCustomColumnRequest (messaggio)
GetSearchAds360FieldRequest (messaggio)
ListAccessibleCustomersRequest (messaggio)
ListAccessibleCustomersResponse (messaggio)
ListCustomColumnsRequest (messaggio)
ListCustomColumnsResponse (messaggio)
RawEventConversionDimensionHeader (messaggio)
RawEventConversionMetricHeader (messaggio)
SearchAds360Row (messaggio)
SearchSearchAds360FieldsRequest (messaggio)
SearchSearchAds360FieldsResponse (messaggio)
SearchSearchAds360Request (messaggio)
SearchSearchAds360Response (messaggio)
SearchSearchAds360StreamRequest (messaggio)
SearchSearchAds360StreamResponse (messaggio)

CustomColumnService

Servizio per la gestione delle colonne personalizzate.

GetCustomColumn

GetCustomColumn
`rpc GetCustomColumn(GetCustomColumnRequest) returns (CustomColumn)` Restituisce la colonna personalizzata richiesta in modo dettagliato. Ambiti di autorizzazione Richiede il seguente ambito OAuth: `https://www.googleapis.com/auth/doubleclicksearch`

rpc GetCustomColumn(GetCustomColumnRequest) returns (CustomColumn)

Restituisce la colonna personalizzata richiesta in modo dettagliato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

ListCustomColumns

ListCustomColumns
`rpc ListCustomColumns(ListCustomColumnsRequest) returns (ListCustomColumnsResponse)` Restituisce tutte le colonne personalizzate associate al cliente nei dettagli. Ambiti di autorizzazione Richiede il seguente ambito OAuth: `https://www.googleapis.com/auth/doubleclicksearch`

rpc ListCustomColumns(ListCustomColumnsRequest) returns (ListCustomColumnsResponse)

Restituisce tutte le colonne personalizzate associate al cliente nei dettagli.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

CustomerService

Servizio per la gestione dei clienti.

ListAccessibleCustomers

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`

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

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`

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

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`

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 tra le risorse.

Cerca

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`

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

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`

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

Intestazione della dimensione personalizzata del messaggio per le conversioni.

Campi

Campi
`id`	`int64` L'ID della dimensione personalizzata della conversione.
`name`	`string` Il nome definito dall'utente della dimensione personalizzata di conversione.

id

int64

L'ID della dimensione personalizzata della conversione.

name

string

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

ConversionCustomMetricHeader

Intestazione della metrica personalizzata del messaggio per le conversioni.

Campi

Campi
`id`	`int64` L'ID della metrica personalizzata di conversione.
`name`	`string` Il nome definito dall'utente della metrica personalizzata di conversione.

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

Campi
`id`	`int64` L'ID colonna personalizzata.
`name`	`string` Il nome della colonna personalizzata definito dall'utente.
`references_metrics`	`bool` True quando la colonna personalizzata fa riferimento a metriche.

id

int64

L'ID colonna personalizzata.

name

string

Il nome della colonna personalizzata definito dall'utente.

references_metrics

bool

True quando la colonna personalizzata fa riferimento a metriche.

GetCustomColumnRequest

Messaggio di richiesta per CustomColumnService.GetCustomColumn.

Campi

Campi
`resource_name`	`string` Obbligatoria. Il nome della risorsa della colonna personalizzata da recuperare.

resource_name

string

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

GetSearchAds360FieldRequest

Messaggio di richiesta per SearchAds360FieldService.GetSearchAds360Field.

Campi

Campi
`resource_name`	`string` Obbligatoria. Il nome della risorsa del campo da ottenere.

resource_name

string

Obbligatoria. Il nome della risorsa del campo da ottenere.

ListAccessibleCustomersRequest

Questo tipo non contiene campi.

Messaggio di richiesta per CustomerService.ListAccessibleCustomers.

ListAccessibleCustomersResponse

Messaggio di risposta per CustomerService.ListAccessibleCustomers.

Campi

Campi
`resource_names[]`	`string` Nome della risorsa dei clienti direttamente accessibile dall'utente che autentica la chiamata.

resource_names[]

string

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

ListCustomColumnsRequest

Richiesta di messaggio per CustomColumnService.ListCustomColumns

Campi

Campi
`customer_id`	`string` Obbligatoria. L'ID del cliente a cui applicare l'operazione di elenco CustomColumn.

customer_id

string

Obbligatoria. L'ID del cliente a cui applicare l'operazione di elenco CustomColumn.

ListCustomColumnsResponse

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

Campi

Campi
`custom_columns[]`	`CustomColumn` Le colonne personalizzate di proprietà del cliente indicato.

custom_columns[]

CustomColumn

Le colonne personalizzate di proprietà del cliente indicato.

RawEventConversionDimensionHeader

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

Campi

Campi
`id`	`int64` L'ID della variabile personalizzata di conversione.
`name`	`string` Il nome definito dall'utente della dimensione evento non elaborata.

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 non elaborata della metrica di conversione dell'evento.

Campi

Campi
`id`	`int64` L'ID della variabile personalizzata di conversione.
`name`	`string` Il nome definito dall'utente della metrica evento non elaborata.

id

int64

L'ID della variabile personalizzata di conversione.

name

string

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

Riga Search Ads360

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_label`	`AdGroupAdLabel` L'etichetta dell'annuncio del gruppo di annunci a cui viene fatto riferimento nella query.
`ad_group_asset`	`AdGroupAsset` L'asset del gruppo di annunci a cui viene fatto 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 viene fatto riferimento nella query.
`ad_group_bid_modifier`	`AdGroupBidModifier` Il modificatore di offerta a cui viene fatto riferimento nella query.
`ad_group_criterion`	`AdGroupCriterion` Il criterio a cui viene fatto riferimento nella query.
`ad_group_criterion_label`	`AdGroupCriterionLabel` L'etichetta del criterio del gruppo di annunci 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 visualizzazione della fascia d'età a cui viene fatto riferimento nella query.
`asset`	`Asset` L'asset a cui viene fatto riferimento nella query.
`asset_group_asset`	`AssetGroupAsset` L'asset del gruppo di asset a cui viene fatto 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 principale del gruppo di asset a cui viene fatto riferimento nella query.
`asset_group`	`AssetGroup` Il gruppo di asset a cui viene fatto riferimento nella query.
`asset_set_asset`	`AssetSetAsset` L'asset del set di asset a cui viene fatto riferimento nella query.
`asset_set`	`AssetSet` L'insieme di asset a cui viene fatto riferimento nella query.
`bidding_strategy`	`BiddingStrategy` La strategia di offerta a cui viene fatto riferimento nella query.
`campaign_budget`	`CampaignBudget` Il budget della campagna a cui viene fatto riferimento nella query.
`campaign`	`Campaign` La campagna a cui viene fatto riferimento nella query.
`campaign_asset`	`CampaignAsset` L'asset della campagna a cui viene fatto riferimento nella query.
`campaign_asset_set`	`CampaignAssetSet` L'insieme di asset della campagna a cui viene fatto riferimento nella query.
`campaign_audience_view`	`CampaignAudienceView` La visualizzazione del segmento di pubblico della campagna a cui viene fatto riferimento nella query.
`campaign_criterion`	`CampaignCriterion` Il criterio della campagna a cui viene fatto riferimento nella query.
`campaign_label`	`CampaignLabel` L'etichetta della campagna a cui viene fatto riferimento nella query.
`cart_data_sales_view`	`CartDataSalesView` La vista vendite dei dati del carrello a cui viene fatto 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 viene fatto riferimento nella query.
`customer`	`Customer` Il cliente a cui viene fatto riferimento nella query.
`customer_asset`	`CustomerAsset` L'asset del cliente a cui viene fatto riferimento nella query.
`customer_asset_set`	`CustomerAssetSet` L'insieme di asset del cliente a cui viene fatto riferimento nella query.
`accessible_bidding_strategy`	`AccessibleBiddingStrategy` La strategia di offerta accessibile a cui viene fatto riferimento nella query.
`customer_manager_link`	`CustomerManagerLink` Il link CustomerManager a cui viene fatto riferimento nella query.
`customer_client`	`CustomerClient` Il CustomerClient a cui viene fatto 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 viene fatto riferimento nella query.
`gender_view`	`GenderView` La vista del genere a cui viene fatto riferimento nella query.
`geo_target_constant`	`GeoTargetConstant` La costante del target geografico a cui viene fatto riferimento nella query.
`keyword_view`	`KeywordView` La visualizzazione delle parole chiave a cui viene fatto riferimento nella query.
`label`	`Label` L'etichetta a cui viene fatto riferimento nella query.
`language_constant`	`LanguageConstant` La costante di lingua a cui viene fatto riferimento nella query.
`location_view`	`LocationView` La visualizzazione della località a cui viene fatto riferimento nella query.
`product_bidding_category_constant`	`ProductBiddingCategoryConstant` La categoria di offerte del prodotto a cui si fa 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 viene fatto riferimento nella query.
`user_list`	`UserList` L'elenco di utenti a cui viene fatto riferimento nella query.
`webpage_view`	`WebpageView` La visualizzazione della pagina web a cui viene fatto 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 viene fatto riferimento nella query.
`metrics`	`Metrics` Le metriche.
`segments`	`Segments` I segmenti.
`custom_columns[]`	`Value` Le colonne personalizzate.

SearchSearchAds360FieldsRequest

Messaggio di richiesta per SearchAds360FieldService.SearchSearchAds360Fields.

Campi

Campi
`query`	`string` Obbligatoria. 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 dei risultati successiva.
`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.

query

string

Obbligatoria. 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 dei risultati successiva.

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

Campi
`results[]`	`SearchAds360Field` L'elenco dei campi corrispondenti alla query.
`next_page_token`	`string` Token di impaginazione utilizzato per recuperare la pagina successiva dei risultati. Passa i contenuti di questa stringa come attributo `page_token` della richiesta successiva. `next_page_token` non è stato restituito per l'ultima pagina.
`total_results_count`	`int64` Numero totale di risultati che corrispondono alla query ignorando la clausola LIMIT.

results[]

SearchAds360Field

L'elenco dei campi corrispondenti alla query.

next_page_token

string

Token di impaginazione utilizzato per recuperare la pagina successiva dei risultati. Passa i contenuti di questa stringa come attributo page_token della richiesta successiva. next_page_token non è stato restituito per l'ultima pagina.

total_results_count

int64

Numero totale di risultati che corrispondono alla query ignorando la clausola LIMIT.

SearchSearchAds360Request

Messaggio di richiesta per SearchAds360Service.Search.

Campi
`customer_id`	`string` Obbligatoria. L'ID del cliente su cui viene eseguita la query.
`query`	`string` Obbligatoria. 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 dei risultati successiva.
`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.
`validate_only`	`bool` Se il valore è true, la richiesta viene convalidata ma non eseguita.
`return_total_results_count`	`bool` Se il valore è true, il numero totale di risultati che corrispondono alla query ignorando 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 da sola in una risposta dopo che saranno stati restituiti tutti gli altri risultati della query.

SearchSearchAds360Response

Messaggio di risposta per SearchAds360Service.Search.

Campi
`results[]`	`SearchAds360Row` L'elenco di righe che corrispondono alla query.
`next_page_token`	`string` Token di impaginazione utilizzato per recuperare la pagina successiva dei risultati. Passa i contenuti di questa stringa come attributo `page_token` della richiesta successiva. `next_page_token` non è stato restituito per l'ultima pagina.
`total_results_count`	`int64` Numero totale di risultati che corrispondono alla query ignorando la clausola LIMIT.
`field_mask`	`FieldMask` FieldMask che rappresenta i campi richiesti dall'utente.
`summary_row`	`SearchAds360Row` Riga di riepilogo che contiene il riepilogo delle metriche nei risultati. Con il riepilogo delle metriche si intende l'aggregazione delle metriche su tutti i risultati; in questo caso, l'aggregazione potrebbe essere somma, media, tasso e così via.
`custom_column_headers[]`	`CustomColumnHeader` Le intestazioni delle colonne personalizzate nei risultati.
`conversion_custom_metric_headers[]`	`ConversionCustomMetricHeader` Le intestazioni delle metriche personalizzate di conversione 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 di conversione degli eventi non elaborate nei risultati.
`raw_event_conversion_dimension_headers[]`	`RawEventConversionDimensionHeader` Le intestazioni delle dimensioni di conversione degli eventi non elaborate nei risultati.

SearchSearchAds360StreamRequest

Messaggio di richiesta per SearchAds360Service.SearchStream.

Campi
`customer_id`	`string` Obbligatoria. L'ID del cliente su cui viene eseguita la query.
`query`	`string` Obbligatoria. La stringa di query.
`batch_size`	`int32` Il numero di righe restituite in ogni batch di risposte in modalità flusso. Quando viene richiesto un batch troppo grande, il server può 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 da sola in una risposta dopo che saranno stati restituiti tutti gli altri risultati della query.

SearchSearchAds360StreamResponse

Messaggio di risposta per SearchAds360Service.SearchStream.

Campi
`results[]`	`SearchAds360Row` L'elenco di righe che corrispondono alla query.
`field_mask`	`FieldMask` FieldMask che rappresenta i campi richiesti dall'utente.
`summary_row`	`SearchAds360Row` Riga di riepilogo che contiene il riepilogo delle metriche nei risultati. Con il riepilogo delle metriche si intende l'aggregazione delle metriche su tutti i risultati; in questo caso, l'aggregazione potrebbe essere somma, media, tasso e così via.
`custom_column_headers[]`	`CustomColumnHeader` Le intestazioni delle colonne personalizzate nei risultati.
`conversion_custom_metric_headers[]`	`ConversionCustomMetricHeader` Le intestazioni delle metriche personalizzate di conversione nei risultati.
`conversion_custom_dimension_headers[]`	`ConversionCustomDimensionHeader` Le intestazioni della dimensione personalizzata di conversione nei risultati.
`raw_event_conversion_metric_headers[]`	`RawEventConversionMetricHeader` Le intestazioni delle metriche di conversione degli eventi non elaborate nei risultati.
`raw_event_conversion_dimension_headers[]`	`RawEventConversionDimensionHeader` Le intestazioni delle dimensioni di conversione degli eventi non elaborate nei risultati.
`request_id`	`string` L'ID univoco della richiesta utilizzato per il debug.