- Zasób: InventorySource
- InventorySourceType
- InventorySourceProductType
- InventorySourceCommitment
- InventorySourceDeliveryMethod
- InventorySourceStatus
- InventorySourceConfigStatus
- RateDetails
- InventorySourceRateType
- Pieniądze
- TimeRange (Zakres czasu).
- CreativeConfig
- InventorySourceDisplayCreativeConfig.
- InventorySourceVideoCreativeConfig
- InventorySourceAccessors
- PartnerAccessor
- AdvertiserAccessors
- Metody
Zasób: InventorySource
Źródło zasobów reklamowych.
Zapis JSON |
---|
{ "name": string, "inventorySourceId": string, "displayName": string, "inventorySourceType": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Nazwa zasobu źródła zasobów reklamowych. |
inventorySourceId |
Tylko dane wyjściowe. Unikalny identyfikator źródła zasobów reklamowych. Przypisana przez system. |
displayName |
Wyświetlana nazwa źródła zasobów reklamowych. Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów. |
inventorySourceType |
Wskazuje typ źródła zasobów reklamowych. |
inventorySourceProductType |
Tylko dane wyjściowe. Typ produktu ze źródła zasobów reklamowych, określający sposób sprzedaży zasobów reklamowych. |
commitment |
Wskazuje, czy źródło zasobów reklamowych ma gwarantowane czy niegwarantowane wyświetlanie. |
deliveryMethod |
Metoda wyświetlania źródła zasobów reklamowych.
|
dealId |
W przestrzeni giełdy identyfikator, który jednoznacznie identyfikuje źródło zasobów reklamowych. Muszą być unikalne dla wszystkich kupujących w obrębie poszczególnych giełd, ale nie zawsze muszą być unikalne na wszystkich giełdach. |
status |
Ustawienia stanu źródła zasobów reklamowych. |
exchange |
Giełda, do której należy źródło zasobów reklamowych. |
updateTime |
Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji źródła zasobów reklamowych. Przypisana przez system. Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
rateDetails |
To pole jest wymagane. Szczegółowe informacje o stawce źródła zasobów reklamowych. |
publisherName |
Nazwa wydawcy/sprzedawcy źródła zasobów reklamowych. |
timeRange |
Zakres czasowy, w którym to źródło zasobów reklamowych ma zacząć i przestać wyświetlać reklamy. |
creativeConfigs[] |
Wymagania dotyczące kreacji związane ze źródłem zasobów reklamowych. Nie dotyczy pakietów aukcji. |
guaranteedOrderId |
Stałe. Identyfikator zamówienia gwarantowanego, do którego należy to źródło zasobów reklamowych. Ma zastosowanie tylko wtedy, gdy |
readWriteAccessors |
Partner lub reklamodawcy z uprawnieniami do odczytu i zapisu w źródle zasobów reklamowych. Dane wyjściowe są generowane tylko wtedy, gdy Wymagane, gdy Jeśli |
readAdvertiserIds[] |
Tylko dane wyjściowe. Identyfikatory reklamodawców z dostępem tylko do odczytu do źródła zasobów reklamowych. |
readPartnerIds[] |
Tylko dane wyjściowe. Identyfikatory partnerów z dostępem tylko do odczytu do źródła zasobów reklamowych. Wszyscy reklamodawcy partnerzy w tym polu dziedziczą dostęp tylko do odczytu do źródła zasobów reklamowych. |
InventorySourceType
Możliwe typy źródeł zasobów reklamowych.
Wartości w polu enum | |
---|---|
INVENTORY_SOURCE_TYPE_UNSPECIFIED |
Typ źródła zasobów reklamowych nie jest określony lub jest w tej wersji nieznany. |
INVENTORY_SOURCE_TYPE_PRIVATE |
Źródło prywatnych zasobów reklamowych. |
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE |
Pakiet aukcji. |
InventorySourceProductType
Możliwe typy produktów ze źródła zasobów reklamowych.
Wartości w polu enum | |
---|---|
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED |
Typ produktu nie został określony lub jest w tej wersji nieznany. Modyfikowanie źródeł zasobów reklamowych tego typu produktów nie jest obsługiwane przez interfejs API. |
PREFERRED_DEAL |
Źródło zasobów reklamowych sprzedaje zasoby w ramach umowy preferencyjnej. |
PRIVATE_AUCTION |
Źródło zasobów reklamowych sprzedaje zasoby na aukcji prywatnej. |
PROGRAMMATIC_GUARANTEED |
Źródło zasobów reklamowych sprzedaje zasoby w ramach automatyzacji gwarantowanej. |
TAG_GUARANTEED |
Źródło zasobów reklamowych sprzedaje zasoby w ramach gwarancji tagu. |
YOUTUBE_RESERVE |
Źródło zasobów reklamowych sprzedaje zasoby w ramach YouTube Reserve. |
INSTANT_RESERVE |
Źródło zasobów reklamowych sprzedaje zasoby w ramach Szybkiej rezerwacji. Modyfikowanie źródeł zasobów reklamowych tego typu produktów nie jest obsługiwane przez interfejs API. |
GUARANTEED_PACKAGE |
Źródło zasobów reklamowych sprzedaje zasoby w ramach pakietu gwarantowanego. Modyfikowanie źródeł zasobów reklamowych tego typu produktów nie jest obsługiwane przez interfejs API. |
PROGRAMMATIC_TV |
Źródło zasobów reklamowych sprzedaje zasoby przez Programmtic TV. Modyfikowanie źródeł zasobów reklamowych tego typu produktów nie jest obsługiwane przez interfejs API. |
AUCTION_PACKAGE |
Źródło zasobów reklamowych sprzedaje zasoby w ramach pakietu aukcji. Modyfikowanie źródeł zasobów reklamowych tego typu produktów nie jest obsługiwane przez interfejs API. |
InventorySourceCommitment
Możliwe typy zobowiązań dla źródła zasobów reklamowych.
Wartości w polu enum | |
---|---|
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED |
Zobowiązanie nie jest określone lub jest nieznane w tej wersji. |
INVENTORY_SOURCE_COMMITMENT_GUARANTEED |
Zobowiązanie jest gwarantowane. |
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED |
Zobowiązanie nie jest gwarantowane. |
InventorySourceDeliveryMethod
Możliwe metody wyświetlania w przypadku źródła zasobów reklamowych.
Wartości w polu enum | |
---|---|
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED |
Metoda dostawy nie jest określona lub jest nieznana w tej wersji. |
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC |
Metoda wyświetlania jest zautomatyzowana. |
INVENTORY_SOURCE_DELIVERY_METHOD_TAG |
Metoda wyświetlania to tag. |
InventorySourceStatus
Ustawienia źródła zasobów reklamowych związane ze stanem.
Zapis JSON |
---|
{ "entityStatus": enum ( |
Pola | |
---|---|
entityStatus |
Wskazuje, czy źródło zasobów reklamowych może być wyświetlane. Akceptowane wartości to |
entityPauseReason |
Podana przez użytkownika przyczyna wstrzymania tego źródła zasobów reklamowych. Nie może przekraczać 100 znaków. Ma zastosowanie tylko wtedy, gdy zasada |
sellerStatus |
Tylko dane wyjściowe. Stan źródła zasobów reklamowych ustawiony przez sprzedawcę. Dotyczy tylko źródeł zasobów reklamowych synchronizowanych bezpośrednio od wydawców. Akceptowane wartości to |
sellerPauseReason |
Tylko dane wyjściowe. Podana przez sprzedawcę przyczyna wstrzymania tego źródła zasobów reklamowych. Dotyczy tylko źródeł zasobów reklamowych zsynchronizowanych bezpośrednio z wydawcami i gdy |
configStatus |
Tylko dane wyjściowe. Stan konfiguracji źródła zasobów reklamowych. Dotyczy tylko gwarantowanych źródeł zasobów reklamowych. Akceptowane wartości to Aby źródło zasobów reklamowych mogło się wyświetlać, musisz je skonfigurować (wypełnij wymagane pola, wybierz kreacje i wybierz kampanię domyślną). |
InventorySourceConfigStatus
Możliwe stany konfiguracji gwarantowanych źródeł zasobów reklamowych.
Wartości w polu enum | |
---|---|
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED |
W tej wersji stan zatwierdzenia nie jest określony lub jest nieznany. |
INVENTORY_SOURCE_CONFIG_STATUS_PENDING |
Stan początkowy gwarantowanego źródła zasobów reklamowych. Źródło zasobów reklamowych w tym stanie musi zostać skonfigurowane. |
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED |
Stan po skonfigurowaniu przez kupującego źródła gwarantowanych zasobów reklamowych. |
RateDetails
Ustawienia źródła zasobów reklamowych związane z ceną.
Zapis JSON |
---|
{ "inventorySourceRateType": enum ( |
Pola | |
---|---|
inventorySourceRateType |
Typ stawki. Akceptowane wartości to |
rate |
Stawka dla źródła zasobów reklamowych. |
unitsPurchased |
Wymagane w przypadku gwarantowanych źródeł zasobów reklamowych. Liczba wyświetleń zagwarantowanych przez sprzedawcę. |
minimumSpend |
Tylko dane wyjściowe. Kwota, którą kupujący zobowiązał się do wydania na źródło zasobów reklamowych. Dotyczy tylko gwarantowanych źródeł zasobów reklamowych. |
InventorySourceRateType
Możliwe typy stawek dla źródła zasobów reklamowych.
Wartości w polu enum | |
---|---|
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED |
Typ stawki nie jest określony lub jest w tej wersji nieznany. |
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED |
Typ stawki to CPM (stała). |
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR |
Typ stawki to CPM (minimalny). |
INVENTORY_SOURCE_RATE_TYPE_CPD |
Typ stawki to Koszt dzienny. |
INVENTORY_SOURCE_RATE_TYPE_FLAT |
Typ stawki to Płaska. |
Pieniądze
Reprezentuje kwotę pieniędzy z typem waluty.
Zapis JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Pola | |
---|---|
currencyCode |
Trzyliterowy kod waluty zgodny z normą ISO 4217. |
units |
Całkowite jednostki kwoty. Jeśli np. |
nanos |
Liczba nano (10^-9) jednostek danej ilości. Wartość musi mieścić się w przedziale od -999 999 999 do +999 999 999 włącznie. Jeśli |
TimeRange
Zakres czasowy.
Zapis JSON |
---|
{ "startTime": string, "endTime": string } |
Pola | |
---|---|
startTime |
To pole jest wymagane. Dolna granica zakresu czasowego włącznie. Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
endTime |
To pole jest wymagane. Górna granica zakresu czasowego włącznie. Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
CreativeConfig
Konfiguracja wymagań dotyczących kreacji dla źródła zasobów reklamowych.
Zapis JSON |
---|
{ "creativeType": enum ( |
Pola | |
---|---|
creativeType |
Typ kreacji, który można przypisać do źródła zasobów reklamowych. Obsługiwane są tylko te typy:
|
Pole sumy
Konfiguracja kreacji, które można przypisać do źródła zasobów reklamowych. |
|
displayCreativeConfig |
Konfiguracja kreacji displayowych. Ma zastosowanie, gdy |
videoCreativeConfig |
Konfiguracja kreacji wideo. Ma zastosowanie, gdy |
InventorySourceDisplayCreativeConfig
Konfiguracja kreacji displayowych.
Zapis JSON |
---|
{
"creativeSize": {
object ( |
Pola | |
---|---|
creativeSize |
Wymagania dotyczące rozmiaru kreacji displayowych, które można przypisać do źródła zasobów reklamowych. |
InventorySourceVideoCreativeConfig
Konfiguracja kreacji wideo.
Zapis JSON |
---|
{ "duration": string } |
Pola | |
---|---|
duration |
Wymagania dotyczące czasu trwania kreacji wideo, które można przypisać do źródła zasobów reklamowych. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
InventorySourceAccessors
Partner lub reklamodawcy z dostępem do źródła zasobów reklamowych.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy accessors . Partner lub reklamodawcy z dostępem do źródła zasobów reklamowych. accessors może być tylko jedną z tych wartości: |
|
partner |
Partner z dostępem do źródła zasobów reklamowych. |
advertisers |
Reklamodawcy z dostępem do źródła zasobów reklamowych. Wszyscy reklamodawcy muszą należeć do tego samego partnera. |
PartnerAccessor
Partner z dostępem do źródła zasobów reklamowych.
Zapis JSON |
---|
{ "partnerId": string } |
Pola | |
---|---|
partnerId |
Identyfikator partnera. |
AdvertiserAccessors
Reklamodawcy z dostępem do źródła zasobów reklamowych.
Zapis JSON |
---|
{ "advertiserIds": [ string ] } |
Pola | |
---|---|
advertiserIds[] |
Identyfikatory reklamodawców. |
Metody |
|
---|---|
|
Tworzy nowe źródło zasobów reklamowych. |
|
Umożliwia edytowanie akcesorów do odczytu i zapisu w przypadku źródła zasobów reklamowych. |
|
Pobiera źródło zasobów reklamowych. |
|
Zawiera listę źródeł zasobów reklamowych, które są dostępne dla bieżącego użytkownika. |
|
Aktualizuje istniejące źródło zasobów reklamowych. |