Risorsa: assuredOrder
Un ordine garantito.
Gli ordini garantiti sono l'entità principale delle origini dell'inventario garantite. Quando crei un'origine dell'inventario garantita, all'origine deve essere assegnato un ID ordine garantito.
Rappresentazione JSON |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
Campi | |
---|---|
name |
Solo output. Il nome della risorsa dell'ordine garantito. |
legacyGuaranteedOrderId |
Solo output. L'ID precedente dell'ordine garantito. Assegnato dalla piattaforma di scambio originale. L'ID precedente è univoco all'interno di una piattaforma di scambio pubblicitario, ma non ne è garantito che sia univoco in tutti gli ordini garantiti. Questo ID viene utilizzato in SDF e nell'interfaccia utente. |
exchange |
obbligatorio. Immutabile. La piattaforma di scambio pubblicitario da cui ha avuto origine l'ordine garantito. |
guaranteedOrderId |
Solo output. L'identificatore univoco dell'ordine garantito. Gli ID ordine garantiti hanno il formato |
displayName |
obbligatorio. Il nome visualizzato dell'ordine garantito. Deve essere codificata in UTF-8 con una dimensione massima di 240 byte. |
status |
Le impostazioni dello stato dell'ordine garantito. |
updateTime |
Solo output. Il timestamp dell'ultimo aggiornamento dell'ordine garantito. Assegnato dal sistema. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
publisherName |
obbligatorio. Il nome del publisher dell'ordine garantito. Deve essere codificata in UTF-8 con una dimensione massima di 240 byte. |
readAccessInherited |
Indica se tutti gli inserzionisti di |
readAdvertiserIds[] |
Gli ID degli inserzionisti con accesso in lettura all'ordine garantito. Questo campo non deve includere l'inserzionista assegnato a |
defaultAdvertiserId |
Solo output. L'ID dell'inserzionista predefinito dell'ordine garantito. L'inserzionista predefinito è |
defaultCampaignId |
L'ID della campagna predefinita assegnato all'ordine garantito. La campagna predefinita deve appartenere all'inserzionista predefinito. |
Campo di unione Il partner o l'inserzionista con accesso in lettura/scrittura all'ordine garantito. |
|
readWritePartnerId |
Il partner con accesso in lettura/scrittura all'ordine garantito. |
readWriteAdvertiserId |
L'inserzionista con accesso in lettura/scrittura all'ordine garantito. Questo è anche l'inserzionista predefinito dell'ordine garantito. |
GuaranteedOrderStatus
Le impostazioni dello stato dell'ordine garantito.
Rappresentazione JSON |
---|
{ "entityStatus": enum ( |
Campi | |
---|---|
entityStatus |
Indica se l'ordine garantito è pubblicabile. I valori accettati sono |
entityPauseReason |
Il motivo fornito dall'utente per la messa in pausa di questo ordine garantito. Deve essere codificata in UTF-8 con una lunghezza massima di 100 byte. Applicabile solo quando |
configStatus |
Solo output. Lo stato di configurazione dell'ordine garantito. I valori accettati sono Prima che possa essere pubblicato, è necessario configurare un ordine garantito (compilare i campi obbligatori, scegliere le creatività e selezionare una campagna predefinita). Attualmente l'azione di configurazione può essere eseguita solo tramite UI. |
GuaranteedOrderConfigStatus
Possibili stati di configurazione per un ordine garantito.
Enum | |
---|---|
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED |
Lo stato di approvazione non è specificato o è sconosciuto in questa versione. |
PENDING |
Lo stato iniziale di un ordine garantito. L'ordine garantito in questo stato deve essere configurato prima di poter essere pubblicato. |
COMPLETED |
Lo stato dopo che l'acquirente ha configurato un ordine garantito. |
Metodi |
|
---|---|
|
Crea un nuovo ordine garantito. |
|
Le modifiche leggono gli inserzionisti di un ordine garantito. |
|
Riceve un ordine garantito. |
|
Elenca gli ordini garantiti accessibili all'utente corrente. |
|
Aggiorna un ordine garantito esistente. |