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

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

string (int64 format)

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

string

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

Musi być zakodowany w standardzie UTF-8 i maksymalnym rozmiarze 240 bajtów.

enum (InventorySourceType)

Wskazuje typ źródła zasobów reklamowych.

enum (InventorySourceProductType)

Tylko dane wyjściowe. Typ produktu, który jest źródłem zasobów reklamowych, wskazujący sposób jego sprzedaży.

enum (InventorySourceCommitment)

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

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 dopuszczalne wartości to INVENTORY_SOURCE_DELIVERY_METHOD_TAG i INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.

string

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

Musi być niepowtarzalna wśród kupujących w ramach każdej giełdy, ale niekoniecznie na wszystkich giełdach.

object (InventorySourceStatus)

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

enum (Exchange)

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

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji źródła zasobów reklamowych. Przypisana przez system.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

object (RateDetails)

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

string

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

object (TimeRange)

Zakres czasowy, w którym dane źródło zasobów reklamowych rozpoczyna się i przestaje wyświetlać reklamy.

object (CreativeConfig)

Wymagania dotyczące kreacji w przypadku źródła zasobów reklamowych.

Nie dotyczy pakietów aukcji.

string

Stały. 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.

object (InventorySourceAccessors)

Partner lub reklamodawcy, którzy mają dostęp do źródła zasobów reklamowych z uprawnieniami do odczytu i zapisu.

Dane wyjściowe tylko wtedy, gdy commitment ma wartość INVENTORY_SOURCE_COMMITMENT_GUARANTEED. W tym przypadku urządzenia dostępu do odczytu i zapisu są dziedziczone z gwarantowanej kolejności nadrzędnej.

Wymagany, gdy commitment to INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED.

Jeśli commitment ma wartość INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED, a w tym polu jest określony partner, wszyscy reklamodawcy, którzy należą do tego partnera, automatycznie uzyskają dostęp tylko do odczytu do źródła zasobów reklamowych. Tacy reklamodawcy nie zostaną uwzględnieni w readAdvertiserIds.

string (int64 format)

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

string (int64 format)

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

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

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

enum (EntityStatus)

Wskazuje, czy źródło zasobów reklamowych może być wyświetlane.

Akceptowane wartości to ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED i ENTITY_STATUS_PAUSED. Wartość domyślna to ENTITY_STATUS_ACTIVE.

string

Podany przez użytkownika powód wstrzymania tego źródła zasobów reklamowych.

Nie może przekraczać 100 znaków.

Ma zastosowanie tylko wtedy, gdy zasada entityStatus ma wartość ENTITY_STATUS_PAUSED.

enum (EntityStatus)

Tylko dane wyjściowe. Stan źródła zasobów reklamowych ustawiony przez sprzedawcę.

Dotyczy tylko źródeł zasobów reklamowych synchronizowanych bezpośrednio przez wydawców. Akceptowane wartości to ENTITY_STATUS_ACTIVE i ENTITY_STATUS_PAUSED.

string

Tylko dane wyjściowe. Powód wstrzymania tego źródła zasobów reklamowych podany przez sprzedawcę.

Dotyczy tylko źródeł zasobów reklamowych synchronizowanych bezpośrednio przez wydawców i gdy sellerStatus ma wartość ENTITY_STATUS_PAUSED.

enum (InventorySourceConfigStatus)

Tylko dane wyjściowe. Stan konfiguracji źródła zasobów reklamowych.

Dotyczy tylko gwarantowanych źródeł zasobów reklamowych. Akceptowane wartości to INVENTORY_SOURCE_CONFIG_STATUS_PENDING i INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED.

Aby źródło zasobów reklamowych mogło się wyświetlać, musisz skonfigurować źródło zasobów reklamowych – wypełnić wymagane pola, wybrać kreacje i wybrać kampanię domyślną.

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

enum (InventorySourceRateType)

Typ stawki.

Akceptowane wartości to INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED, INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR i INVENTORY_SOURCE_RATE_TYPE_CPD.

object (Money)

Stawka źródła zasobów reklamowych.

string (int64 format)

Wymagane w przypadku gwarantowanych źródeł zasobów reklamowych. Liczba wyświetleń gwarantowanych przez sprzedawcę.

object (Money)

Tylko dane wyjściowe. Kwota, którą kupujący zobowiązał się wydać z góry na źródło zasobów reklamowych.

Dotyczy tylko gwarantowanych źródeł zasobów reklamowych.

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

string

Trzyliterowy kod waluty zdefiniowany w normie ISO 4217.

string (int64 format)

Całkowita jednostka kwoty. Jeśli na przykład currencyCode to "USD", 1 jednostka to 1 zł.

integer

Liczba jednostek nano (10^-9) ilości. Wartość musi mieścić się w zakresie od -999 999 999 do +999 999 999 włącznie. Jeśli units ma wartość dodatnią, nanos musi być liczbą dodatnią lub zero. Jeśli units ma wartość 0, nanos może być liczbą dodatnią, zerową lub ujemną. Jeśli units ma wartość ujemną, nanos musi mieć wartość ujemną lub zero. Na przykład -1,75 zł jest przedstawione jako units=-1 i nanos=-750 000 000.

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

string (Timestamp format)

Wymagane. Dolna granica zakresu czasu włącznie.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Wymagane. Górna granica zakresu czasu włącznie.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "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)

Typ kreacji, który można przypisać do źródła zasobów reklamowych. Obsługiwane są tylko te typy:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_VIDEO

object (InventorySourceDisplayCreativeConfig)

Konfiguracja kreacji displayowych. Obowiązuje, gdy creativeType ma wartość CREATIVE_TYPE_STANDARD.

object (InventorySourceVideoCreativeConfig)

Konfiguracja kreacji wideo. Obowiązuje, gdy creativeType ma wartość CREATIVE_TYPE_VIDEO.

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

object (Dimensions)

Wymagania dotyczące rozmiaru kreacji displayowych, które można przypisać do źródła zasobów reklamowych.

{
  "duration": string
}

string (Duration format)

Wymagania dotyczące czasu trwania kreacji wideo, które można przypisać do źródła zasobów reklamowych.

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „s”. Przykład: "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)

Partner z dostępem do źródła zasobów reklamowych.

object (AdvertiserAccessors)

Reklamodawcy z dostępem do źródła zasobów reklamowych. Wszyscy reklamodawcy muszą należeć do tego samego partnera.

{
  "partnerId": string
}

string (int64 format)

Identyfikator partnera.

{
  "advertiserIds": [
    string
  ]
}

string (int64 format)

Identyfikatory reklamodawców.