- משאב: 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 |
המזהה במרחב ה-Exchange שמזהה באופן ייחודי את מקור מלאי שטחי הפרסום. חובה שיהיו ייחודיים בין הקונים בכל הבורסות, אבל לא בהכרח בבורסות השונות. |
status |
הגדרות הסטטוס של מקור מלאי שטחי הפרסום. |
exchange |
מקור ה-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 |
מקור המלאי מוכר את המלאי באמצעות Programmatic commitmentd. |
TAG_GUARANTEED |
מקור המלאי מוכר מלאי באמצעות 'אומת על ידי Tag'. |
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 |
סוג התעריף הוא עלות לאלף חשיפות (Floor). |
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[] |
המזהים של המפרסמים. |
שיטות |
|
---|---|
|
יוצר מקור חדש של מלאי שטחי פרסום. |
|
עורך את רכיבי הגישה לקריאה/כתיבה של מקור מלאי. |
|
הפונקציה מקבלת מקור מלאי. |
|
בתיבת הדו שיח הזו רשומים מקורות של מלאי שטחי פרסום שאליהם המשתמש הנוכחי יכול לגשת. |
|
עדכון מקור קיים של מלאי שטחי פרסום. |