- משאב: InventorySource
- InventorySourceType
- InventorySourceProductType
- InventorySourceCommitment
- InventorySourceDeliveryMethod
- InventorySourceStatus
- InventorySourceConfigStatus
- RateDetails
- InventorySourceRateType
- Money
- TimeRange
- CreativeConfig
- InventorySourceDisplayCreativeConfig
- InventorySourceVideoCreativeConfig
- InventorySourceAccessors
- PartnerAccessor
- AdvertiserAccessors
- שיטות
משאב: InventorySource
מקור של מלאי שטחי פרסום.
ייצוג JSON |
---|
{ "name": string, "inventorySourceId": string, "displayName": string, "inventorySourceType": enum ( |
שדות | |
---|---|
name |
פלט בלבד. שם המשאב של מקור מלאי שטחי הפרסום. |
inventorySourceId |
פלט בלבד. המזהה הייחודי של מקור מלאי שטחי הפרסום. הוקצה על ידי המערכת. |
displayName |
השם המוצג של המקור של מלאי שטחי הפרסום. חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים. |
inventorySourceType |
מציין את סוג המקור של מלאי שטחי הפרסום. |
inventorySourceProductType |
פלט בלבד. סוג המוצר של מקור המלאי, שמציין את הדרך שבה הוא מוכר את המלאי. |
commitment |
האם למקור המלאי יש מסירה מובטחת או לא מובטחת. |
deliveryMethod |
שיטת השליחה של מקור המלאי.
|
dealId |
המזהה במרחב החליפין שמזהה באופן ייחודי את מקור המלאי. המזהה צריך להיות ייחודי אצל כל הקונים בכל בורסה, אבל לא בהכרח ייחודי לכל הפלטפורמות. |
status |
הגדרות הסטטוס של מקור מלאי שטחי הפרסום. |
exchange |
ערך ההחלפה שאליו שייך המקור של מלאי שטחי הפרסום. |
updateTime |
פלט בלבד. חותמת הזמן של העדכון האחרון של מקור מלאי שטחי הפרסום. הוקצה על ידי המערכת. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
rateDetails |
חובה. פרטי התעריפים של מקור מלאי שטחי הפרסום. |
publisherName |
שם בעל התוכן הדיגיטלי/המוכר של המקור של מלאי שטחי הפרסום. |
timeRange |
טווח הזמן שבו מקור מלאי שטחי הפרסום הזה מתחיל ומפסיק להציג מודעות. |
creativeConfigs[] |
הדרישות בנוגע לקריאייטיב של מקור המלאי. לא רלוונטי לחבילות מסוג מכרזים. |
guaranteedOrderId |
בלתי משתנה. המזהה של ההזמנה המובטחת שאליה שייך המקור הזה של מלאי שטחי הפרסום. רלוונטי רק כשהערך בשדה |
readWriteAccessors |
השותף או המפרסמים שיש להם גישת קריאה/כתיבה למקור של מלאי שטחי הפרסום. הפלט רק כאשר חובה כשהערך בשדה אם הערך של |
readAdvertiserIds[] |
פלט בלבד. המזהים של מפרסמים עם הרשאת קריאה בלבד למקור של מלאי שטחי הפרסום. |
readPartnerIds[] |
פלט בלבד. המזהים של שותפים שיש להם הרשאת קריאה בלבד למקור של מלאי שטחי הפרסום. כל המפרסמים של שותפים בשדה הזה יורשים את הרשאת הקריאה בלבד למקור מלאי שטחי הפרסום. |
InventorySourceType
סוגים אפשריים של מקורות מלאי.
טיפוסים בני מנייה (enums) | |
---|---|
INVENTORY_SOURCE_TYPE_UNSPECIFIED |
סוג המקור של מלאי שטחי הפרסום לא צוין או שאינו ידוע בגרסה הזו. |
INVENTORY_SOURCE_TYPE_PRIVATE |
מקור של מלאי פרטי. |
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE |
חבילה למכירה פומבית. |
InventorySourceProductType
סוגי מוצרים אפשריים של מקור מלאי.
טיפוסים בני מנייה (enums) | |
---|---|
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED |
סוג המוצר לא צוין או שאינו ידוע בגרסה הזו. לא ניתן לשנות מקורות של מלאי שטחי פרסום מסוג המוצר הזה באמצעות API. |
PREFERRED_DEAL |
מקור המלאי מוכר את המלאי באמצעות Preferred Deal. |
PRIVATE_AUCTION |
מקור המלאי מוכר מלאי דרך מכרז פרטי. |
PROGRAMMATIC_GUARANTEED |
מקור המלאי מוכר מלאי באמצעות פרוגרמטי מובטח. |
TAG_GUARANTEED |
מקור המלאי מוכר מלאי באמצעות 'אומת תג'. |
YOUTUBE_RESERVE |
מקור המלאי מוכר את המלאי דרך YouTube Reserve. |
INSTANT_RESERVE |
מקור המלאי מוכר מלאי באמצעות הזמנה מיידית. לא ניתן לשנות מקורות של מלאי שטחי פרסום מסוג המוצר הזה באמצעות API. |
GUARANTEED_PACKAGE |
מקור המלאי מוכר מלאי באמצעות 'חבילה מובטחת'. לא ניתן לשנות מקורות של מלאי שטחי פרסום מסוג המוצר הזה באמצעות API. |
PROGRAMMATIC_TV |
מקור המלאי מוכר מלאי דרך Programmtic TV. לא ניתן לשנות מקורות של מלאי שטחי פרסום מסוג המוצר הזה באמצעות API. |
AUCTION_PACKAGE |
מקור המלאי מוכר מלאי דרך חבילת מכרז. לא ניתן לשנות מקורות של מלאי שטחי פרסום מסוג המוצר הזה באמצעות API. |
InventorySourceCommitment
סוגי התחייבויות אפשריים למקור מלאי.
טיפוסים בני מנייה (enums) | |
---|---|
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED |
ההתחייבות לא צוינה או שהיא לא ידועה בגרסה הזו. |
INVENTORY_SOURCE_COMMITMENT_GUARANTEED |
ההתחייבות למסירה מובטחת. |
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED |
ההתחייבות אינה מסירה מובטחת. |
InventorySourceDeliveryMethod
שיטות אפשריות להצגת מודעות למקור של מלאי שטחי פרסום.
טיפוסים בני מנייה (enums) | |
---|---|
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED |
שיטת ההעברה לא צוינה או לא ידועה בגרסה הזו. |
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC |
שיטת ההצגה היא פרוגרמטית. |
INVENTORY_SOURCE_DELIVERY_METHOD_TAG |
שיטת ההצגה היא תג. |
InventorySourceStatus
ההגדרות שקשורות לסטטוס במקור של מלאי שטחי הפרסום.
ייצוג JSON |
---|
{ "entityStatus": enum ( |
שדות | |
---|---|
entityStatus |
האם ניתן או לא ניתן להציג את מקור המלאי. הערכים הקבילים הם |
entityPauseReason |
הסיבה שהמשתמש סיפק להשהיית המקור של מלאי שטחי הפרסום הזה. האורך המקסימלי הוא 100 תווים. רלוונטי רק כאשר |
sellerStatus |
פלט בלבד. הסטטוס שנקבע על ידי בית העסק עבור מקור המלאי. רלוונטי רק למקורות של מלאי שטחי פרסום שמסונכרנים ישירות מבעלי האפליקציות. הערכים הקבילים הם |
sellerPauseReason |
פלט בלבד. הסיבה להשהיית המקור של מלאי שטחי הפרסום שסופק על ידי בית העסק. רלוונטי רק למקורות של מלאי שטחי פרסום שמסונכרנים ישירות מבעלי האפליקציות, כאשר |
configStatus |
פלט בלבד. סטטוס ההגדרה של מקור המלאי. רלוונטי רק למקורות של מלאי שטחי פרסום עם התחייבות למחיר הנמוך ביותר. הערכים הקבילים הם כדי שאפשר יהיה להציג את המודעה, צריך להגדיר מקור של מלאי שטחי פרסום (למלא את שדות החובה, לבחור נכסי קריאייטיב ולבחור קמפיין ברירת מחדל). |
InventorySourceConfigStatus
מצבי הגדרה אפשריים למקור של מלאי שטחי פרסום מובטח.
טיפוסים בני מנייה (enums) | |
---|---|
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED |
סטטוס האישור לא צוין או שאינו ידוע בגרסה זו. |
INVENTORY_SOURCE_CONFIG_STATUS_PENDING |
המצב ההתחלתי של מקור של מלאי שטחי פרסום מובטח. צריך להגדיר את מקור המלאי למודעות במצב הזה. |
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED |
המצב שאחרי שהקונה מגדיר מקור מובטח של מלאי שטחי פרסום. |
RateDetails
ההגדרות שקשורות לתעריפים במקור של מלאי שטחי הפרסום.
ייצוג JSON |
---|
{ "inventorySourceRateType": enum ( |
שדות | |
---|---|
inventorySourceRateType |
סוג התעריף. הערכים הקבילים הם |
rate |
התעריף של המקור של מלאי שטחי הפרסום. |
unitsPurchased |
חובה לספק מקורות מובטחים של מלאי שטחי פרסום. מספר החשיפות שבית העסק מבטיח. |
minimumSpend |
פלט בלבד. הסכום שהקונה התחייב להוציא על מקור המלאי מראש. רלוונטי רק למקורות של מלאי שטחי פרסום עם התחייבות למחיר הנמוך ביותר. |
InventorySourceRateType
סוגי תעריפים אפשריים למקור של מלאי שטחי פרסום.
טיפוסים בני מנייה (enums) | |
---|---|
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED |
סוג התעריף לא צוין או שאינו ידוע בגרסה זו. |
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED |
סוג התעריף הוא עלות לאלף חשיפות (קבועה). |
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR |
סוג התעריף הוא CPM (קומה). |
INVENTORY_SOURCE_RATE_TYPE_CPD |
סוג התעריף הוא 'עלות ליום'. |
INVENTORY_SOURCE_RATE_TYPE_FLAT |
סוג התעריף הוא 'קבוע'. |
כסף
מייצג סכום כסף עם סוג המטבע שלו.
ייצוג JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
שדות | |
---|---|
currencyCode |
קוד המטבע בן שלוש האותיות המוגדר בתקן ISO 4217. |
units |
מספר היחידות השלמות של הסכום. לדוגמה, אם הערך של |
nanos |
מספר יחידות הננו (10^-9) של הסכום. הערך חייב להיות בין -999,999,999 ו+999,999,999, כולל. אם הערך של |
TimeRange
טווח זמן.
ייצוג JSON |
---|
{ "startTime": string, "endTime": string } |
שדות | |
---|---|
startTime |
חובה. הגבול התחתון של טווח זמן, כולל. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
endTime |
חובה. הגבול העליון של טווח זמן, כולל. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
CreativeConfig
הגדרת הדרישות לקריאייטיב במקור של מלאי שטחי הפרסום.
ייצוג JSON |
---|
{ "creativeType": enum ( |
שדות | |
---|---|
creativeType |
סוג הקריאייטיב שאפשר להקצות למקור של מלאי שטחי הפרסום. יש תמיכה רק בסוגים הבאים:
|
שדה איחוד
ההגדרה של נכסי הקריאייטיב שאפשר להקצות למקור של מלאי שטחי הפרסום. |
|
displayCreativeConfig |
התצורה של מודעות קריאייטיב לרשת המדיה. תקף אם הערך של |
videoCreativeConfig |
התצורה של קריאייטיבים של וידאו. תקף אם הערך של |
InventorySourceDisplayCreativeConfig
התצורה של מודעות קריאייטיב לרשת המדיה.
ייצוג JSON |
---|
{
"creativeSize": {
object ( |
שדות | |
---|---|
creativeSize |
דרישות הגודל לגבי נכסי קריאייטיב לרשת המדיה שאפשר להקצות למקור המלאי. |
InventorySourceVideoCreativeConfig
התצורה של קריאייטיבים של וידאו.
ייצוג JSON |
---|
{ "duration": string } |
שדות | |
---|---|
duration |
דרישות משך הזמן של נכסי הקריאייטיב של הווידאו שאפשר להקצות למקור של מלאי שטחי הפרסום. משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-' |
InventorySourceAccessors
השותף או המפרסמים שיש להם גישה למקור של מלאי שטחי הפרסום.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד accessors . השותף או המפרסמים שיש להם גישה למקור של מלאי שטחי הפרסום. accessors יכול להיות רק אחד מהבאים: |
|
partner |
השותף שיש לו גישה למקור של מלאי שטחי הפרסום. |
advertisers |
המפרסמים שיש להם גישה למקור של מלאי שטחי הפרסום. כל המפרסמים חייבים להשתייך לאותו שותף. |
PartnerAccessor
השותף שיש לו גישה למקור של מלאי שטחי הפרסום.
ייצוג JSON |
---|
{ "partnerId": string } |
שדות | |
---|---|
partnerId |
המזהה של השותף. |
AdvertiserAccessors
המפרסמים שיש להם גישה למקור של מלאי שטחי הפרסום.
ייצוג JSON |
---|
{ "advertiserIds": [ string ] } |
שדות | |
---|---|
advertiserIds[] |
המזהים של המפרסמים. |
שיטות |
|
---|---|
|
יצירת מקור חדש של מלאי שטחי פרסום. |
|
עורכים את רכיבי הגישה לקריאה/כתיבה של מקור מלאי. |
|
הפונקציה מקבלת מקור של מלאי שטחי פרסום. |
|
בתיבת הדו-שיח הזו מפורטים מקורות של מלאי שטחי פרסום שנגישים למשתמש הנוכחי. |
|
עדכון מקור קיים של מלאי שטחי פרסום. |