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 modo dettagliato.

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 nei dettagli.

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

Intestazione della dimensione personalizzata del messaggio per le conversioni.

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

string

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

GetSearchAds360FieldRequest

Messaggio di richiesta per SearchAds360FieldService.GetSearchAds360Field.

Campi
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
resource_names[]

string

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

ListCustomColumnsRequest

Richiesta di messaggio per CustomColumnService.ListCustomColumns

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

Campi
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_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
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
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.