- Risorsa: InventorySource
- InventorySourceType
- InventorySourceProductType
- InventorySourceCommitment
- InventorySourceDeliveryMethod
- InventorySourceStatus
- InventorySourceConfigStatus
- RateDetails
- InventorySourceRateType
- Valore monetario
- TimeRange
- CreativeConfig
- InventorySourceDisplayCreativeConfig
- InventorySourceVideoCreativeConfig
- InventorySourceAccessors
- PartnerAccessor
- AdvertiserAccessors
- Metodi
Risorsa: InventorySource
Un'origine dell'inventario.
Rappresentazione JSON |
---|
{ "name": string, "inventorySourceId": string, "displayName": string, "inventorySourceType": enum ( |
Campi | |
---|---|
name |
Solo output. Il nome della risorsa dell'origine dell'inventario. |
inventorySourceId |
Solo output. L'ID univoco dell'origine dell'inventario. Assegnato dal sistema. |
displayName |
Il nome visualizzato dell'origine dell'inventario. Deve essere codificata in UTF-8 con una dimensione massima di 240 byte. |
inventorySourceType |
Indica il tipo di origine dell'inventario. |
inventorySourceProductType |
Solo output. Il tipo di prodotto dell'origine dell'inventario, che indica il modo in cui vende l'inventario. |
commitment |
Indica se l'origine dell'inventario ha una pubblicazione garantita o non garantita. |
deliveryMethod |
Il metodo di pubblicazione dell'origine dell'inventario.
|
dealId |
L'ID nello spazio della piattaforma di scambio pubblicitario che identifica in modo univoco l'origine dell'inventario. Deve essere univoco per gli acquirenti all'interno di ogni piattaforma di scambio pubblicitario, ma non necessariamente per tutte le piattaforme di scambio pubblicitario. |
status |
Le impostazioni dello stato dell'origine dell'inventario. |
exchange |
La piattaforma di scambio pubblicitario a cui appartiene l'origine dell'inventario. |
updateTime |
Solo output. Il timestamp dell'ultimo aggiornamento dell'origine dell'inventario. Assegnato dal sistema. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
rateDetails |
obbligatorio. I dettagli della tariffa dell'origine dell'inventario. |
publisherName |
Il nome del publisher/venditore dell'origine dell'inventario. |
timeRange |
L'intervallo di tempo in cui inizia e termina la pubblicazione di questa origine dell'inventario. |
creativeConfigs[] |
I requisiti delle creatività dell'origine dell'inventario. Non applicabile ai pacchetti di aste. |
guaranteedOrderId |
Immutabile. L'ID dell'ordine garantito a cui appartiene questa origine dell'inventario. Applicabile solo quando |
readWriteAccessors |
Il partner o gli inserzionisti con accesso in lettura/scrittura all'origine dell'inventario. Restituisce un output solo quando Obbligatorio quando Se |
readAdvertiserIds[] |
Solo output. Gli ID degli inserzionisti con accesso di sola lettura all'origine dell'inventario. |
readPartnerIds[] |
Solo output. Gli ID dei partner con accesso di sola lettura all'origine dell'inventario. Tutti gli inserzionisti dei partner in questo campo ereditano l'accesso di sola lettura all'origine dell'inventario. |
InventorySourceType
Possibili tipi di origini dell'inventario.
Enum | |
---|---|
INVENTORY_SOURCE_TYPE_UNSPECIFIED |
Il tipo di origine dell'inventario non è specificato o è sconosciuto in questa versione. |
INVENTORY_SOURCE_TYPE_PRIVATE |
Origine dell'inventario privato. |
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE |
Pacchetto di aste. |
InventorySourceProductType
Possibili tipi di prodotto di un'origine dell'inventario.
Enum | |
---|---|
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED |
Il tipo di prodotto non è specificato o è sconosciuto in questa versione. La modifica delle origini dell'inventario di questo tipo di prodotto non è supportata tramite l'API. |
PREFERRED_DEAL |
L'origine dell'inventario vende l'inventario tramite Preferred deal. |
PRIVATE_AUCTION |
L'origine dell'inventario vende l'inventario tramite l'asta privata. |
PROGRAMMATIC_GUARANTEED |
L'origine dell'inventario vende inventario tramite la pubblicità programmatica garantita. |
TAG_GUARANTEED |
L'origine dell'inventario vende inventario tramite tag garantiti. |
YOUTUBE_RESERVE |
L'origine dell'inventario vende inventario tramite YouTube Reserve. |
INSTANT_RESERVE |
L'origine dell'inventario vende inventario tramite Prenotazione istantanea. La modifica delle origini dell'inventario di questo tipo di prodotto non è supportata tramite l'API. |
GUARANTEED_PACKAGE |
L'origine dell'inventario vende inventario tramite il pacchetto di pubblicità garantita. La modifica delle origini dell'inventario di questo tipo di prodotto non è supportata tramite l'API. |
PROGRAMMATIC_TV |
L'origine dell'inventario vende inventario tramite la TV programmatica. La modifica delle origini dell'inventario di questo tipo di prodotto non è supportata tramite l'API. |
AUCTION_PACKAGE |
L'origine dell'inventario vende l'inventario tramite il pacchetto di aste. La modifica delle origini dell'inventario di questo tipo di prodotto non è supportata tramite l'API. |
InventorySourceCommitment
Possibili tipi di impegno per un'origine dell'inventario.
Enum | |
---|---|
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED |
L'impegno non è specificato o è sconosciuto in questa versione. |
INVENTORY_SOURCE_COMMITMENT_GUARANTEED |
L'impegno è garantito. |
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED |
L'impegno è una pubblicazione non garantita. |
InventorySourceDeliveryMethod
Possibili metodi di pubblicazione per un'origine dell'inventario.
Enum | |
---|---|
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED |
Il metodo di pubblicazione non è specificato o è sconosciuto in questa versione. |
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC |
Il metodo di pubblicazione è programmatico. |
INVENTORY_SOURCE_DELIVERY_METHOD_TAG |
Il metodo di recapito è mediante tag. |
InventorySourceStatus
Le impostazioni relative allo stato dell'origine dell'inventario.
Rappresentazione JSON |
---|
{ "entityStatus": enum ( |
Campi | |
---|---|
entityStatus |
Indica se l'origine dell'inventario è pubblicabile. I valori accettati sono |
entityPauseReason |
Il motivo fornito dall'utente per la messa in pausa di questa origine dell'inventario. Non deve superare i 100 caratteri. Applicabile solo quando |
sellerStatus |
Solo output. Lo stato impostato dal venditore per l'origine dell'inventario. Valido solo per le origini dell'inventario sincronizzate direttamente dai publisher. I valori accettati sono |
sellerPauseReason |
Solo output. Il motivo fornito dal venditore per la messa in pausa di questa origine dell'inventario. Valido solo per le origini dell'inventario sincronizzate direttamente dai publisher e quando il criterio |
configStatus |
Solo output. Lo stato di configurazione dell'origine dell'inventario. Valido solo per le origini dell'inventario garantite. I valori accettati sono Prima di poter essere pubblicata, è necessario configurare un'origine dell'inventario (compila i campi obbligatori, scegli le creatività e seleziona una campagna predefinita). |
InventorySourceConfigStatus
Possibili stati di configurazione per un'origine dell'inventario garantita.
Enum | |
---|---|
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED |
Lo stato di approvazione non è specificato o è sconosciuto in questa versione. |
INVENTORY_SOURCE_CONFIG_STATUS_PENDING |
Lo stato iniziale di un'origine dell'inventario garantita. L'origine dell'inventario in questo stato deve essere configurata. |
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED |
Lo stato dopo che l'acquirente ha configurato un'origine dell'inventario garantita. |
RateDetails
Le impostazioni relative alla tariffa dell'origine dell'inventario.
Rappresentazione JSON |
---|
{ "inventorySourceRateType": enum ( |
Campi | |
---|---|
inventorySourceRateType |
Il tipo di tariffa. I valori accettati sono |
rate |
L'indice dell'origine dell'inventario. |
unitsPurchased |
Obbligatorio per le origini dell'inventario garantite. Il numero di impressioni garantite dal venditore. |
minimumSpend |
Solo output. L'importo che l'acquirente si è impegnato a spendere in anticipo sull'origine dell'inventario. Valido solo per le origini dell'inventario garantite. |
InventorySourceRateType
Possibili tipi di indice per un'origine dell'inventario.
Enum | |
---|---|
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED |
Il tipo di tariffa non è specificato o è sconosciuto in questa versione. |
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED |
Il tipo di tariffa è CPM (fisso). |
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR |
Il tipo di tariffa è CPM (minimo). |
INVENTORY_SOURCE_RATE_TYPE_CPD |
Il tipo di tariffa è Costo giornaliero. |
INVENTORY_SOURCE_RATE_TYPE_FLAT |
Il tipo di tariffa è fissa. |
Denaro
Rappresenta una quantità di denaro con il suo tipo di valuta.
Rappresentazione JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Campi | |
---|---|
currencyCode |
Il codice valuta di tre lettere definito nello standard ISO 4217. |
units |
Le unità intere dell'importo. Ad esempio, se |
nanos |
Numero di nano (10^-9) unità della quantità. Il valore deve essere compreso tra -999.999.999 e +999.999.999 inclusi. Se |
TimeRange
Un intervallo di tempo.
Rappresentazione JSON |
---|
{ "startTime": string, "endTime": string } |
Campi | |
---|---|
startTime |
obbligatorio. Il limite inferiore di un intervallo di tempo (incluso). Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
endTime |
obbligatorio. Il limite superiore di un intervallo di tempo (incluso). Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
CreativeConfig
Configurazione dei requisiti delle creatività per l'origine dell'inventario.
Rappresentazione JSON |
---|
{ "creativeType": enum ( |
Campi | |
---|---|
creativeType |
Il tipo di creatività che può essere assegnato all'origine dell'inventario. Sono supportati solo i seguenti tipi:
|
Campo di unione
La configurazione delle creatività che possono essere assegnate all'origine dell'inventario. |
|
displayCreativeConfig |
La configurazione per le creatività display. Applicabile quando |
videoCreativeConfig |
La configurazione per le creatività video. Applicabile quando |
InventorySourceDisplayCreativeConfig
La configurazione per le creatività display.
Rappresentazione JSON |
---|
{
"creativeSize": {
object ( |
Campi | |
---|---|
creativeSize |
I requisiti di dimensione per le creatività display che possono essere assegnate all'origine dell'inventario. |
InventorySourceVideoCreativeConfig
La configurazione per le creatività video.
Rappresentazione JSON |
---|
{ "duration": string } |
Campi | |
---|---|
duration |
I requisiti di durata per le creatività video che possono essere assegnate all'origine dell'inventario. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
InventorySourceAccessors
Il partner o gli inserzionisti con accesso all'origine dell'inventario.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione accessors . Il partner o gli inserzionisti con accesso all'origine dell'inventario. accessors può essere solo uno dei seguenti: |
|
partner |
Il partner con accesso all'origine dell'inventario. |
advertisers |
Gli inserzionisti con accesso all'origine dell'inventario. Tutti gli inserzionisti devono appartenere allo stesso partner. |
PartnerAccessor
Il partner con accesso all'origine dell'inventario.
Rappresentazione JSON |
---|
{ "partnerId": string } |
Campi | |
---|---|
partnerId |
L'ID del partner. |
AdvertiserAccessors
Gli inserzionisti con accesso all'origine dell'inventario.
Rappresentazione JSON |
---|
{ "advertiserIds": [ string ] } |
Campi | |
---|---|
advertiserIds[] |
Gli ID degli inserzionisti. |
Metodi |
|
---|---|
|
Crea una nuova origine dell'inventario. |
|
Modifica le funzioni di accesso di lettura/scrittura di un'origine dell'inventario. |
|
Recupera un'origine dell'inventario. |
|
Elenca le origini dell'inventario accessibili all'utente corrente. |
|
Consente di aggiornare un'origine dell'inventario esistente. |