L'API Display & Video 360 v1beta2 è stata dismessa. Le richieste a una versione ritirata potrebbero restituire un errore.
Devi utilizzare l'API Display & Video 360 v2. Consulta la nostra guida alla migrazione per conoscere la procedura di migrazione da v1 a v2.
Method: advertisers.campaigns.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elenca le campagne in un inserzionista.
L'ordine è definito dal parametro orderBy
. Se filter
di entityStatus
non viene specificato, le campagne con ENTITY_STATUS_ARCHIVED
non verranno incluse nei risultati.
Richiesta HTTP
GET https://displayvideo.googleapis.com/v1beta2/advertisers/{advertiserId}/campaigns
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
advertiserId |
string (int64 format)
L'ID dell'inserzionista per il quale elencare le campagne.
|
Parametri di ricerca
Parametri |
pageSize |
integer
Dimensioni della pagina richiesta. Il valore deve essere compreso tra 1 e 100 . Se non specificati, il valore predefinito sarà 100 .
|
pageToken |
string
Un token che identifica una pagina di risultati che il server deve restituire. In genere, si tratta del valore di nextPageToken restituito dalla precedente chiamata al metodo campaigns.list . Se non specificato, verrà restituita la prima pagina di risultati.
|
orderBy |
string
Campo in base al quale ordinare l'elenco. I valori accettati sono:
displayName (valore predefinito)
entityStatus
updateTime
L'ordinamento predefinito è crescente. Per specificare l'ordine decrescente di un campo, aggiungi un suffisso "desc" al nome del campo. Esempio: displayName desc .
|
filter |
string
Consente di filtrare in base alle proprietà della campagna. Sintassi supportata:
- Le espressioni di filtro sono composte da una o più limitazioni.
- Le restrizioni possono essere combinate dagli operatori logici
AND o OR . Una sequenza di limitazioni utilizza implicitamente AND .
- Una restrizione ha il seguente formato:
{field} {operator} {value} .
- L'operatore utilizzato su
updateTime deve essere GREATER THAN OR EQUAL TO (>=) o LESS THAN OR EQUAL TO (<=) .
- L'operatore deve essere
EQUALS (=) .
- Campi supportati:
campaignId
displayName
entityStatus
updateTime (input nel formato ISO 8601 o AAAA-MM-GGTHH:MM:SSZ)
Esempi:
- Tutte le campagne
ENTITY_STATUS_ACTIVE o ENTITY_STATUS_PAUSED di un inserzionista: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED")
- Tutte le campagne con una durata di aggiornamento inferiore o uguale a
2020-11-04T18:54:47Z (format of ISO 8601) : updateTime<="2020-11-04T18:54:47Z"
- Tutte le campagne con una data/ora di aggiornamento superiore o uguale a
2020-11-04T18:54:47Z (format of ISO 8601) : updateTime>="2020-11-04T18:54:47Z"
La lunghezza di questo campo non deve superare i 500 caratteri.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
{
"campaigns": [
{
object (Campaign )
}
],
"nextPageToken": string
} |
Campi |
campaigns[] |
object (Campaign )
L'elenco delle campagne. Questo elenco non sarà presente se vuoto.
|
nextPageToken |
string
Un token per recuperare la pagina di risultati successiva. Passa questo valore nel campo pageToken nella chiamata successiva al metodo campaigns.list per recuperare la pagina dei risultati successiva.
|
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/display-video
https://www.googleapis.com/auth/display-video-mediaplanning
Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2023-12-02 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Mancano le informazioni di cui ho bisogno"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Troppo complicato/troppi passaggi"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Obsoleti"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problema di traduzione"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problema relativo a esempi/codice"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Altra"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Facile da capire"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Il problema è stato risolto"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Altra"
}]