REST Resource: partners.inventorySources

Ressource: InventorySource

Eine Inventarquelle.

JSON-Darstellung 
{
  "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
  ]
}
Felder
name

string

Nur Ausgabe. Der Ressourcenname der Inventarquelle.
inventorySourceId

string (int64 format)

Nur Ausgabe. Die eindeutige ID der Inventarquelle. Wird vom System zugewiesen.
displayName

string

Der Anzeigename der Inventarquelle.

Muss UTF-8-codiert sein und darf maximal 240 Byte groß sein.
inventorySourceType

enum (InventorySourceType)

Gibt den Typ der Inventarquelle an.
inventorySourceProductType

enum (InventorySourceProductType)

Nur Ausgabe. Der Produkttyp der Inventarquelle, der angibt, wie Inventar verkauft wird.
commitment

enum (InventorySourceCommitment)

Gibt an, ob die Inventarquelle eine garantierte oder nicht garantierte Auslieferung hat.
deliveryMethod

enum (InventorySourceDeliveryMethod)

Die Auslieferungsmethode der Inventarquelle.

  • Für nicht garantierte Inventarquellen ist der einzige zulässige Wert INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
  • Für garantierte Inventarquellen sind die Werte INVENTORY_SOURCE_DELIVERY_METHOD_TAG und INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC zulässig.
dealId

string

Die ID im Anzeigenplattformbereich, die die Inventarquelle eindeutig identifiziert.

Muss für jeden Käufer innerhalb einer Anzeigenplattform eindeutig sein, aber nicht unbedingt für alle Anzeigenplattformen.
status

object (InventorySourceStatus)

Die Statuseinstellungen der Inventarquelle.
exchange

enum (Exchange)

Die Anzeigenplattform, zu der die Inventarquelle gehört.
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann die Inventarquelle zuletzt aktualisiert wurde. Wird vom System zugewiesen.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
rateDetails

object (RateDetails)

Erforderlich. Die Preisdetails der Inventarquelle.
publisherName

string

Der Name des Publishers/Verkäufers der Inventarquelle.
timeRange

object (TimeRange)

Der Zeitraum, in dem die Auslieferung dieser Inventarquelle beginnt und endet.
creativeConfigs[]

object (CreativeConfig)

Die Creative-Anforderungen der Inventarquelle.

Nicht zutreffend für Auktionspakete.
guaranteedOrderId

string

Nicht veränderbar. Die ID des garantierten Deals, zu dem diese Inventarquelle gehört.

Gilt nur, wenn commitment INVENTORY_SOURCE_COMMITMENT_GUARANTEED ist.
readWriteAccessors

object (InventorySourceAccessors)

Der Partner oder die Werbetreibenden, die Lese-/Schreibzugriff auf die Inventarquelle haben.

Wird nur ausgegeben, wenn commitment den Wert INVENTORY_SOURCE_COMMITMENT_GUARANTEED hat. In diesem Fall werden die Lese-/Schreibzugriffsfunktionen vom übergeordneten garantierten Auftrag übernommen.

Erforderlich, wenn der commitment INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED ist.

Wenn commitment auf INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED festgelegt ist und in diesem Feld ein Partner angegeben ist, haben alle Werbetreibenden unter diesem Partner automatisch Lesezugriff auf die Inventarquelle. Diese Werbetreibenden werden nicht in readAdvertiserIds aufgenommen.
readAdvertiserIds[]

string (int64 format)

Nur Ausgabe. Die IDs der Werbetreibenden mit Lesezugriff auf die Inventarquelle.
readPartnerIds[]

string (int64 format)

Nur Ausgabe. Die IDs der Partner mit Lesezugriff auf die Inventarquelle.

Alle Werbetreibenden von Partnern in diesem Feld erhalten Lesezugriff auf die Inventarquelle.

Methoden

get

 Ruft einen Deal für eine Inventarquelle ab.

list

 Listet Deals für Inventarquellen auf.