- 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 wyświetlanie gwarantowane czy niegwarantowane. |
deliveryMethod |
Metoda wyświetlania źródła zasobów reklamowych.
|
dealId |
Identyfikator w przestrzeni giełdy, który jednoznacznie identyfikuje źródło zasobów reklamowych. Musi być niepowtarzalna wśród kupujących w obrębie każdej giełdy, ale nie musi być niepowtarzalna na poszczególnych 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 RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
rateDetails |
To pole jest wymagane. Szczegóły stawki źródła zasobów reklamowych. |
publisherName |
Nazwa wydawcy/sprzedawcy źródła zasobów reklamowych. |
timeRange |
Zakres czasu, 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. Ustawienie nie jest stosowane w przypadku pakietów aukcji. |
guaranteedOrderId |
Niezmienne. 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 zapisu i odczytu źródła 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 partnerów w tym polu dziedziczą dostęp do źródła zasobów reklamowych z uprawnieniami tylko do odczytu. |
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 nieznany w tej wersji. |
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 |
W tej wersji typ produktu nie jest określony lub jest 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 je w ramach umowy preferencyjnej. |
PRIVATE_AUCTION |
To źródło sprzedaje zasoby reklamowe na aukcji prywatnej. |
PROGRAMMATIC_GUARANTEED |
Źródło zasobów reklamowych sprzedaje je 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 je sprzedaje w ramach YouTube Reserve. |
INSTANT_RESERVE |
Źródło zasobów reklamowych je sprzedaje 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 je w ramach pakietu gwarantowanego. Modyfikowanie źródeł zasobów reklamowych tego typu produktów nie jest obsługiwane przez interfejs API. |
PROGRAMMATIC_TV |
To źródło sprzedaje zasoby reklamowe w ramach 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 to gwarantowane wyświetlanie reklam. |
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 |
Określa, 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. Tekst nie może przekraczać 100 znaków. Ma zastosowanie tylko wtedy, gdy zasada |
sellerStatus |
Tylko dane wyjściowe. Stan ustawiony przez sprzedawcę dla źródła zasobów reklamowych. 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 danymi wydawców 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 Źródło zasobów reklamowych musi zostać skonfigurowane (wypełnij wymagane pola, wybierz kreacje i wybierz kampanię domyślną), by umożliwić wyświetlanie reklam. |
InventorySourceConfigStatus
Możliwe stany konfiguracji gwarantowanego źródła zasobów reklamowych.
Wartości w polu enum | |
---|---|
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED |
Stan zatwierdzenia nie jest określony lub nieznany w tej wersji. |
INVENTORY_SOURCE_CONFIG_STATUS_PENDING |
Stan początkowy gwarantowanego źródła zasobów reklamowych. Musisz skonfigurować źródło zasobów reklamowych w tym stanie. |
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 ze stawką.
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 nieznany w tej wersji. |
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED |
Typ stawki to CPM (stała). |
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR |
Typ stawki to CPM (minimalne). |
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 wraz z typem waluty.
Zapis JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Pola | |
---|---|
currencyCode |
Trzyliterowy kod waluty zdefiniowany w normie ISO 4217. |
units |
Całe jednostki kwoty. Jeśli np. |
nanos |
Liczba nano (10^-9) jednostek 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 czasu włącznie. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
endTime |
To pole jest wymagane. Górna granica zakresu czasu włącznie. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
CreativeConfig
Konfiguracja wymagań dotyczących kreacji na potrzeby źródła zasobów reklamowych.
Zapis JSON |
---|
{ "creativeType": enum ( |
Pola | |
---|---|
creativeType |
Typ kreacji, którą 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 mieć 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. |
|
Edytuje akcesory do odczytu i zapisu źródła zasobów reklamowych. |
|
Pobiera źródło zasobów reklamowych. |
|
Wyświetla 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. |