REST Resource: partners.inventorySources

Zasób: InventorySource

Źródło zasobów reklamowych.

Zapis 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
  ]
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu źródła zasobów reklamowych.
inventorySourceId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator źródła zasobów reklamowych. Przypisany przez system.
displayName

string

Wyświetlana nazwa źródła zasobów reklamowych.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów.
inventorySourceType

enum (InventorySourceType)

Określa typ źródła zasobów reklamowych.
inventorySourceProductType

enum (InventorySourceProductType)

Tylko dane wyjściowe. Typ produktu źródła zasobów reklamowych, który określa sposób sprzedaży zasobów reklamowych.
commitment

enum (InventorySourceCommitment)

Określa, czy źródło zasobów reklamowych ma gwarantowane czy niegwarantowane wyświetlanie.
deliveryMethod

enum (InventorySourceDeliveryMethod)

Metoda wyświetlania źródła zasobów reklamowych.

  • W przypadku niegwarantowanych źródeł zasobów reklamowych jedyną akceptowaną wartością jest INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
  • W przypadku gwarantowanych źródeł zasobów reklamowych akceptowane wartości to INVENTORY_SOURCE_DELIVERY_METHOD_TAG i INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
dealId

string

Identyfikator w przestrzeni giełdy, który jednoznacznie identyfikuje źródło zasobów reklamowych.

Musi być unikalny dla kupujących w ramach każdej giełdy, ale niekoniecznie unikalny dla różnych giełd.
status

object (InventorySourceStatus)

Ustawienia stanu źródła zasobów reklamowych.
exchange

enum (Exchange)

Giełda, do której należy źródło zasobów reklamowych.
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa określająca, kiedy źródło zasobów reklamowych zostało ostatnio zaktualizowane. Przypisany przez system.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
rateDetails

object (RateDetails)

Wymagane. Szczegóły stawki źródła zasobów reklamowych.
publisherName

string

Nazwa wydawcy lub sprzedawcy źródła zasobów reklamowych.
timeRange

object (TimeRange)

Zakres czasu, w którym to źródło zasobów reklamowych zaczyna i kończy wyświetlanie reklam.
creativeConfigs[]

object (CreativeConfig)

Wymagania dotyczące kreacji w źródle zasobów reklamowych.

Nie dotyczy pakietów aukcyjnych.
guaranteedOrderId

string

Wartość niezmienna. Identyfikator gwarantowanego zamówienia, do którego należy to źródło zasobów reklamowych.

Ma zastosowanie tylko wtedy, gdy commitment to INVENTORY_SOURCE_COMMITMENT_GUARANTEED.
readWriteAccessors

object (InventorySourceAccessors)

Partner lub reklamodawcy, którzy mają uprawnienia do zapisu i odczytu w przypadku źródła zasobów reklamowych.

Dane wyjściowe tylko wtedy, gdy commitment to INVENTORY_SOURCE_COMMITMENT_GUARANTEED. W takim przypadku akcesory odczytu/zapisu są dziedziczone z nadrzędnego zamówienia gwarantowanego.

Wymagane, gdy commitment to INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED.

Jeśli commitment to INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED, a w tym polu ustawiony jest partner, wszyscy reklamodawcy należący do tego partnera będą automatycznie mieć dostęp tylko do odczytu do źródła zasobów reklamowych. Ci reklamodawcy nie zostaną uwzględnieni w usłudze readAdvertiserIds.
readAdvertiserIds[]

string (int64 format)

Tylko dane wyjściowe. Identyfikatory reklamodawców z dostępem tylko do odczytu do źródła zasobów reklamowych.
readPartnerIds[]

string (int64 format)

Tylko dane wyjściowe. Identyfikatory partnerów, którzy mają dostęp tylko do odczytu do źródła zasobów reklamowych.

Wszyscy reklamodawcy partnerów w tym polu dziedziczą dostęp tylko do odczytu do źródła zasobów reklamowych.

Metody

get

 Pobiera umowę dotyczącą źródła zasobów reklamowych.

list

 Wyświetla listę umów dotyczących źródeł zasobów reklamowych.