Ogni nuovo elemento pubblicitario deve dichiarare se pubblicherà o meno annunci politici dell'Unione Europea (UE). I caricamenti di API Display & Video 360 e SDF che non forniscono dichiarazioni non andranno a buon fine. Per ulteriori dettagli, consulta la nostra pagina relativa ai ritiri.
Obbligatorio. L'ID dell'inserzionista a cui appartengono i gruppi di annunci.
Parametri di query
Parametri
pageSize
integer
(Facoltativo) Dimensioni della pagina richiesta. Il valore deve essere compreso tra 1 e 100. Se non specificato, il valore predefinito è 100. Restituisce il codice di errore INVALID_ARGUMENT se viene specificato un valore non valido.
pageToken
string
(Facoltativo) Un token che identifica una pagina di risultati che il server deve restituire. In genere, questo è il valore di nextPageToken restituito dalla chiamata precedente al metodo adGroupAds.list. Se non specificato, verrà restituita la prima pagina dei risultati.
orderBy
string
(Facoltativo) Campo in base al quale ordinare l'elenco. I valori accettabili sono:
displayName (valore predefinito)
entityStatus
L'ordinamento predefinito è crescente. Per specificare l'ordine decrescente per un campo, al nome del campo deve essere aggiunto il suffisso "desc". Esempio: displayName desc.
filter
string
(Facoltativo) Consente il filtraggio in base ai campi degli annunci dei gruppi di annunci personalizzati.
Sintassi supportata:
Le espressioni di filtro sono costituite da una o più limitazioni.
Le limitazioni possono essere combinate tramite AND e OR. Una sequenza di limitazioni utilizza implicitamente AND.
Una limitazione ha la forma di {field} {operator} {value}.
Tutti i campi devono utilizzare l'operatore EQUALS (=).
Campi supportati:
adGroupId
displayName
entityStatus
adGroupAdId
Esempi:
Tutti gli annunci del gruppo di annunci in un gruppo di annunci: adGroupId="1234"
Tutti gli annunci del gruppo di annunci in un gruppo di annunci con entityStatus ENTITY_STATUS_ACTIVE o ENTITY_STATUS_PAUSED: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED") AND
adGroupId="12345"
La lunghezza di questo campo non deve superare i 500 caratteri.
Un token per recuperare la pagina successiva dei risultati. Passa questo valore nel campo pageToken nella chiamata successiva al metodo adGroupAds.list per recuperare la pagina successiva dei risultati.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-10 UTC."],[],["This document outlines the process of listing ad group ads via the `adGroupAds.list` method. It requires a `GET` request to a specific URL, using the advertiser's ID as a path parameter. Optional query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter` enable pagination, sorting, and filtering. The request body must be empty. The response body will include a list of ad group ads and a `nextPageToken` for pagination. The process requires OAuth authorization with the `https://www.googleapis.com/auth/display-video` scope.\n"],null,[]]
