REST Resource: partners.inventorySources

Recurso: InventorySource

Uma origem de inventário.

Representação JSON 
{
  "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
  ]
}
Campos
name

string

Apenas saída. O nome do recurso da origem de inventário.
inventorySourceId

string (int64 format)

Apenas saída. O ID exclusivo da origem de inventário. Atribuído pelo sistema.
displayName

string

O nome de exibição da origem de inventário.

Precisa ser codificado em UTF-8 com um tamanho máximo de 240 bytes.
inventorySourceType

enum (InventorySourceType)

Indica o tipo da origem de inventário.
inventorySourceProductType

enum (InventorySourceProductType)

Apenas saída. O tipo de produto da origem de inventário, que indica como ela vende o inventário.
commitment

enum (InventorySourceCommitment)

Se a origem de inventário tem uma exibição garantida ou não garantida.
deliveryMethod

enum (InventorySourceDeliveryMethod)

O método de exibição da origem de inventário.

  • Para origens de inventário não garantidas, o único valor aceitável é INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
  • Para origens de inventário garantidas, os valores aceitáveis são INVENTORY_SOURCE_DELIVERY_METHOD_TAG e INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
dealId

string

O ID no espaço da troca que identifica exclusivamente a origem de inventário.

Precisa ser exclusivo para os compradores em cada troca, mas não necessariamente em todas as trocas.
status

object (InventorySourceStatus)

As configurações de status da origem de inventário.
exchange

enum (Exchange)

A troca a que a origem de inventário pertence.
updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora da última atualização da origem de inventário. Atribuído pelo sistema.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
rateDetails

object (RateDetails)

Obrigatório. Os detalhes da taxa da origem de inventário.
publisherName

string

O nome do editor/vendedor da origem de inventário.
timeRange

object (TimeRange)

O período em que essa origem de inventário começa e para de veicular.
creativeConfigs[]

object (CreativeConfig)

Os requisitos de criativo da origem de inventário.

Não relevante para pacotes de leilão.
guaranteedOrderId

string

Imutável. O ID do pedido garantido a que essa origem de inventário pertence.

Aplicável somente quando commitment é INVENTORY_SOURCE_COMMITMENT_GUARANTEED.
readWriteAccessors

object (InventorySourceAccessors)

O parceiro ou os anunciantes que têm acesso de leitura/gravação à origem de inventário.

Somente saída quando commitment é INVENTORY_SOURCE_COMMITMENT_GUARANTEED. Nesse caso, os acessadores de leitura/gravação são herdados do pedido garantido pai.

Obrigatório quando commitment é INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED.

Se commitment for INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED e um parceiro for definido nesse campo, todos os anunciantes desse parceiro terão automaticamente acesso somente leitura à origem de inventário. Esses anunciantes não serão incluídos em readAdvertiserIds.
readAdvertiserIds[]

string (int64 format)

Apenas saída. Os IDs dos anunciantes com acesso somente leitura à origem de inventário.
readPartnerIds[]

string (int64 format)

Apenas saída. Os IDs dos parceiros com acesso somente leitura à origem de inventário.

Todos os anunciantes de parceiros neste campo herdam o acesso somente leitura à origem de inventário.

Métodos

get

 Recebe uma transação de origem de inventário.

list

 Lista as transações de origem de inventário.