Ricerca e SearchStream

Video: report

L'API Google Ads dispone di un recupero degli attributi e di report sulle metriche unificati meccanismo di attenzione che ti consente di creare query utilizzando lo strumento Query di Google Ads Lingua. Ciò permette query complesse che possono restituire grandi quantità di dati singoli account Google Ads.

Puoi creare query utilizzando il metodo Search o SearchStream. Entrambi i metodi supportano le stesse query e restituiscono risultati equivalenti. La Il metodo Search restituisce dati in pagine di dimensioni fisse di 10.000 righe, consentendoti eseguire l'iterazione su un set di risultati utilizzando l'impaginazione. Questo potrebbe essere vantaggioso nel larghezza di banda larga o condizioni di rete inaffidabili, ad esempio per segmentare un risultato impostato in risposte più piccole che possono essere recuperate nuovamente se viene hanno perso. Il metodo SearchStream, invece, trasmette in streaming l'intero risultato in un'unica risposta, il che può essere più efficiente per i dati in blocco recupero.

Sia Search sia SearchStream utilizzano lo stesso URL di base:

    https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds
POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}

Se i risultati contengono più di 10.000 righe,viene restituito un nextPageToken restituito nella risposta:

{
  "results": [
    // ...
    // ...
    // ...
  ],
  "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
  "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}

La stessa query viene ripetuta con l'aggiunta di pageToken con i valori della classe richiesta precedente recupera la pagina dei risultati successiva:

POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'",
"pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B"
}

Per utilizzare il metodo SearchStream, che restituisce tutti i risultati in un unico flusso di dati risposta, cambia il metodo del servizio nell'URL in searchStream (pageSize e pageToken non sono obbligatori per SearchStream):

POST /v17/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

{
    "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}