REST Resource: inventorySources

{
  "name": string,
  "inventorySourceId": string,
  "displayName": string,
  "inventorySourceType": enum (InventorySourceType),
  "inventorySourceProductType": enum (InventorySourceProductType),
  "commitment": enum (InventorySourceCommitment),
  "deliveryMethod": enum (InventorySourceDeliveryMethod),
  "dealId": string,
  "status": {
    object (InventorySourceStatus)
  },
  "exchange": enum (Exchange),
  "updateTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "publisherName": string,
  "timeRange": {
    object (TimeRange)
  },
  "creativeConfigs": [
    {
      object (CreativeConfig)
    }
  ],
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}

string

Solo output. Il nome della risorsa dell'origine dell'inventario.

string (int64 format)

Solo output. L'ID univoco dell'origine dell'inventario. Assegnato dal sistema.

string

Il nome visualizzato dell'origine dell'inventario.

Deve essere codificata in UTF-8 con una dimensione massima di 240 byte.

enum (InventorySourceType)

Indica il tipo di origine dell'inventario.

enum (InventorySourceProductType)

Solo output. Il tipo di prodotto dell'origine dell'inventario, che indica il modo in cui vende l'inventario.

enum (InventorySourceCommitment)

Indica se l'origine dell'inventario ha una pubblicazione garantita o non garantita.

enum (InventorySourceDeliveryMethod)

Il metodo di pubblicazione dell'origine dell'inventario.

• Per le origini dell'inventario non garantite, l'unico valore accettabile è INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
• Per le origini dell'inventario garantite, i valori accettabili sono INVENTORY_SOURCE_DELIVERY_METHOD_TAG e INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.

string

L'ID nello spazio di scambio che identifica in modo univoco l'origine dell'inventario.

Deve essere univoco per tutti gli acquirenti all'interno di ogni piattaforma di scambio pubblicitario, ma non necessariamente in un'altra piattaforma.

object (InventorySourceStatus)

Le impostazioni dello stato dell'origine dell'inventario.

enum (Exchange)

La piattaforma di scambio pubblicitario a cui appartiene l'origine dell'inventario.

string (Timestamp format)

Solo output. Il timestamp dell'ultimo aggiornamento dell'origine dell'inventario. Assegnato dal sistema.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (RateDetails)

Obbligatorio. I dettagli delle tariffe dell'origine dell'inventario.

string

Il nome del publisher/venditore dell'origine dell'inventario.

object (TimeRange)

L'intervallo di tempo in cui inizia e smette di pubblicare questa origine dell'inventario.

object (CreativeConfig)

I requisiti delle creatività dell'origine dell'inventario.

Non applicabile per i pacchetti di aste.

string

Immutabile. L'ID dell'ordine garantito a cui appartiene questa origine dell'inventario.

Applicabile solo quando commitment è INVENTORY_SOURCE_COMMITMENT_GUARANTEED.

object (InventorySourceAccessors)

Il partner o gli inserzionisti che hanno accesso in lettura/scrittura all'origine dell'inventario.

Viene restituito un output solo quando commitment è INVENTORY_SOURCE_COMMITMENT_GUARANTEED, nel qual caso le funzioni di accesso in lettura/scrittura vengono ereditate dall'ordine padre garantito.

Obbligatorio quando commitment è INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED.

Se il criterio commitment è INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED e in questo campo è impostato un partner, tutti gli inserzionisti al suo interno avranno automaticamente accesso di sola lettura all'origine dell'inventario. Questi inserzionisti non saranno inclusi in readAdvertiserIds.

string (int64 format)

Solo output. Gli ID degli inserzionisti con accesso di sola lettura all'origine dell'inventario.

string (int64 format)

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.

{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "sellerStatus": enum (EntityStatus),
  "sellerPauseReason": string,
  "configStatus": enum (InventorySourceConfigStatus)
}

enum (EntityStatus)

Indica se l'origine dell'inventario è pubblicabile o meno.

I valori accettati sono ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED e ENTITY_STATUS_PAUSED. Il valore predefinito è ENTITY_STATUS_ACTIVE.

string

Il motivo fornito dall'utente per la messa in pausa di questa origine dell'inventario.

Non deve superare i 100 caratteri.

Applicabile solo quando il criterio entityStatus è impostato su ENTITY_STATUS_PAUSED.

enum (EntityStatus)

Solo output. Lo stato impostato dal venditore per l'origine dell'inventario.

Applicabile solo alle origini dell'inventario sincronizzate direttamente dai publisher. I valori accettati sono ENTITY_STATUS_ACTIVE e ENTITY_STATUS_PAUSED.

string

Solo output. Il motivo fornito dal venditore per la messa in pausa di questa origine dell'inventario.

Applicabile solo alle origini dell'inventario sincronizzate direttamente dai publisher e quando il valore sellerStatus è impostato su ENTITY_STATUS_PAUSED.

enum (InventorySourceConfigStatus)

Solo output. Lo stato di configurazione dell'origine dell'inventario.

Valido solo per le origini dell'inventario garantite. I valori accettati sono INVENTORY_SOURCE_CONFIG_STATUS_PENDING e INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED.

Per poter essere pubblicata, è necessario configurare un'origine dell'inventario (compila i campi obbligatori, scegli le creatività e seleziona una campagna predefinita).

{
  "inventorySourceRateType": enum (InventorySourceRateType),
  "rate": {
    object (Money)
  },
  "unitsPurchased": string,
  "minimumSpend": {
    object (Money)
  }
}

enum (InventorySourceRateType)

Il tipo di tariffa.

I valori accettati sono INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED, INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR e INVENTORY_SOURCE_RATE_TYPE_CPD.

object (Money)

La tariffa per l'origine dell'inventario.

string (int64 format)

Obbligatorio per le origini dell'inventario garantite. Il numero di impressioni garantite dal venditore.

object (Money)

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.

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

Il codice valuta di tre lettere definito in ISO 4217.

string (int64 format)

Le unità intere dell'importo. Ad esempio, se currencyCode è "USD", 1 unità equivale a un dollaro statunitense.

integer

Numero di nano (10^-9) unità della quantità. Il valore deve essere compreso tra -999.999.999 e +999.999.999 (inclusi). Se units è positivo, nanos deve essere positivo o zero. Se units è zero, nanos può essere positivo, zero o negativo. Se units è negativo, nanos deve essere negativo o zero. Ad esempio -1,75 $ è rappresentato come units=-1 e nanos=-750.000.000.

{
  "startTime": string,
  "endTime": string
}

string (Timestamp format)

Obbligatorio. Il limite inferiore di un intervallo di tempo, incluso.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Obbligatorio. Il limite superiore di un intervallo di tempo, incluso.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

{
  "creativeType": enum (CreativeType),

  // Union field creative_config_scheme can be only one of the following:
  "displayCreativeConfig": {
    object (InventorySourceDisplayCreativeConfig)
  },
  "videoCreativeConfig": {
    object (InventorySourceVideoCreativeConfig)
  }
  // End of list of possible types for union field creative_config_scheme.
}

enum (CreativeType)

Il tipo di creatività che può essere assegnato all'origine dell'inventario. Sono supportati solo i seguenti tipi:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_VIDEO

object (InventorySourceDisplayCreativeConfig)

La configurazione delle creatività display. Applicabile quando creativeType è CREATIVE_TYPE_STANDARD.

object (InventorySourceVideoCreativeConfig)

La configurazione delle creatività video. Applicabile quando creativeType è CREATIVE_TYPE_VIDEO.

{
  "creativeSize": {
    object (Dimensions)
  }
}

object (Dimensions)

I requisiti relativi alle dimensioni per le creatività display che possono essere assegnate all'origine dell'inventario.

{
  "duration": string
}

string (Duration format)

I requisiti di durata per le creatività video che possono essere assegnate all'origine dell'inventario.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

{

  // Union field accessors can be only one of the following:
  "partner": {
    object (PartnerAccessor)
  },
  "advertisers": {
    object (AdvertiserAccessors)
  }
  // End of list of possible types for union field accessors.
}

object (PartnerAccessor)

Il partner con accesso all'origine dell'inventario.

object (AdvertiserAccessors)

Gli inserzionisti con accesso all'origine dell'inventario. Tutti gli inserzionisti devono appartenere allo stesso partner.

{
  "partnerId": string
}

string (int64 format)

L'ID del partner.

{
  "advertiserIds": [
    string
  ]
}

string (int64 format)

Gli ID degli inserzionisti.