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

Nur Ausgabe. Der Ressourcenname der Inventarquelle.

string (int64 format)

Nur Ausgabe. Die eindeutige ID der Inventarquelle. Vom System zugewiesen.

string

Der Anzeigename der Inventarquelle.

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

enum (InventorySourceType)

Der Typ der Inventarquelle.

enum (InventorySourceProductType)

Nur Ausgabe. Der Produkttyp der Inventarquelle. Er gibt an, wie Inventar verkauft wird.

enum (InventorySourceCommitment)

Ob die Inventarquelle eine garantierte oder nicht garantierte Auslieferung hat

enum (InventorySourceDeliveryMethod)

Die Auslieferungsmethode der Inventarquelle.

• Bei nicht garantierten Inventarquellen ist INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC der einzige akzeptable Wert.
• Bei garantierten Inventarquellen sind die zulässigen Werte INVENTORY_SOURCE_DELIVERY_METHOD_TAG und INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.

string

Die ID im Anzeigenplattformbereich, die die Inventarquelle eindeutig identifiziert.

Sie müssen für die Käufer in jeder Anzeigenplattform eindeutig, aber nicht unbedingt für die verschiedenen Anzeigenplattformen eindeutig sein.

object (InventorySourceStatus)

Die Statuseinstellungen der Inventarquelle.

enum (Exchange)

Die Anzeigenplattform, zu der die Inventarquelle gehört.

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel der letzten Aktualisierung der Inventarquelle. Vom System zugewiesen.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

object (RateDetails)

Erforderlich. Die Preisdetails der Inventarquelle.

string

Der Name des Publishers/Verkäufers der Inventarquelle.

object (TimeRange)

Der Zeitraum, in dem die Auslieferung der Inventarquelle beginnt und endet.

object (CreativeConfig)

Das sind die Creative-Anforderungen der Inventarquelle.

Gilt nicht für Auktionspakete.

string

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

Gilt nur, wenn „commitment“ den Wert „INVENTORY_SOURCE_COMMITMENT_GUARANTEED“ hat.

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 Zugriffsfunktionen für Lese-/Schreibzugriff von der übergeordneten garantierten Reihenfolge übernommen.

Erforderlich, wenn commitment den Wert INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED hat.

Wenn commitment auf INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED gesetzt 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.

string (int64 format)

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

string (int64 format)

Nur Ausgabe. Die IDs der Partner, die Lesezugriff auf die Inventarquelle haben.

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

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

enum (EntityStatus)

Gibt an, ob die Inventarquelle auslieferbar ist.

Zulässige Werte sind ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED und ENTITY_STATUS_PAUSED. Der Standardwert ist ENTITY_STATUS_ACTIVE.

string

Der vom Nutzer angegebene Grund für das Pausieren dieser Inventarquelle.

Darf nicht länger als 100 Zeichen sein.

Gilt nur, wenn entityStatus auf ENTITY_STATUS_PAUSED gesetzt ist.

enum (EntityStatus)

Nur Ausgabe. Das ist der vom Verkäufer für die Inventarquelle festgelegte Status.

Gilt nur für Inventarquellen, die direkt von den Publishern synchronisiert werden. Zulässige Werte sind ENTITY_STATUS_ACTIVE und ENTITY_STATUS_PAUSED.

string

Nur Ausgabe. Der vom Verkäufer angegebene Grund für das Pausieren dieser Inventarquelle.

Gilt nur für Inventarquellen, die direkt von den Publishern synchronisiert werden und wenn sellerStatus auf ENTITY_STATUS_PAUSED gesetzt ist.

enum (InventorySourceConfigStatus)

Nur Ausgabe. Der Konfigurationsstatus der Inventarquelle.

Gilt nur für garantierte Inventarquellen. Zulässige Werte sind INVENTORY_SOURCE_CONFIG_STATUS_PENDING und INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED.

Bevor Anzeigen ausgeliefert werden können, muss eine Inventarquelle konfiguriert werden. Füllen Sie dazu die Pflichtfelder aus, wählen Sie Creatives aus und legen Sie eine Standardkampagne fest.

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

enum (InventorySourceRateType)

Der Preistyp.

Zulässige Werte sind INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED, INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR und INVENTORY_SOURCE_RATE_TYPE_CPD.

object (Money)

Der Preis für die Inventarquelle.

string (int64 format)

Erforderlich für garantierte Inventarquellen. Die Anzahl der vom Verkäufer garantierten Impressionen.

object (Money)

Nur Ausgabe. Der Betrag, den sich der Käufer verpflichtet hat, im Voraus für die Inventarquelle auszugeben.

Gilt nur für garantierte Inventarquellen.

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

string

Der dreistellige Währungscode gemäß ISO 4217.

string (int64 format)

Die ganzen Einheiten des Betrags. Beispiel: Wenn currencyCode den Wert "USD" hat, entspricht eine Einheit 1 US-Dollar.

integer

Anzahl der Nanoeinheiten (10^-9) des Betrags. Der Wert muss im Bereich von -999.999.999 bis +999.999.999 liegen. Wenn units positiv ist, muss nanos positiv oder null sein. Wenn units null ist, kann nanos positiv, null oder negativ sein. Wenn units negativ ist, muss nanos negativ oder null sein. Beispiel: -1,75 $ wird als units=-1 und nanos=-750.000.000 dargestellt.

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

string (Timestamp format)

Erforderlich. Die Untergrenze eines Zeitraums (einschließlich).

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Erforderlich. Die Obergrenze eines Zeitraums (einschließlich).

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "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)

Der Creative-Typ, der der Inventarquelle zugewiesen werden kann. Nur die folgenden Gebotstypen werden unterstützt:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_VIDEO

object (InventorySourceDisplayCreativeConfig)

Die Konfiguration für Displaynetzwerk-Creatives. Anwendbar, wenn creativeType den Wert CREATIVE_TYPE_STANDARD hat.

object (InventorySourceVideoCreativeConfig)

Die Konfiguration für Video-Creatives. Anwendbar, wenn creativeType den Wert CREATIVE_TYPE_VIDEO hat.

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

object (Dimensions)

Die Größenanforderungen für Display-Creatives, die der Inventarquelle zugewiesen werden können

{
  "duration": string
}

string (Duration format)

Das sind die Anforderungen an die Dauer der Video-Creatives, die der Inventarquelle zugewiesen werden können.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "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)

Der Partner mit Zugriff auf die Inventarquelle.

object (AdvertiserAccessors)

Die Werbetreibenden mit Zugriff auf die Inventarquelle. Alle Werbetreibenden müssen zum selben Partner gehören.

{
  "partnerId": string
}

string (int64 format)

Die ID des Partners.

{
  "advertiserIds": [
    string
  ]
}

string (int64 format)

Die IDs der Werbetreibenden.