מקור: ProvidedOrder
הזמנה מובטחת.
הזמנות מובטחות הן ישות אם של מקורות מלאי מובטחים. כשיוצרים מקור מובטח של מלאי שטחי פרסום, צריך להקצות מזהה הזמנה מובטח למקור של מלאי שטחי הפרסום.
ייצוג JSON |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
שדות | |
---|---|
name |
פלט בלבד. שם המשאב של ההזמנה המובטחת. |
legacyGuaranteedOrderId |
פלט בלבד. המזהה הקודם של ההזמנה המובטחת. הוקצה על ידי ההחלפה המקורית. המזהה הקודם הוא ייחודי במסגרת פלטפורמת Exchange אחת, אבל לא מובטח שהוא יהיה ייחודי בכל ההזמנות עם התחייבות. המזהה הזה נמצא בשימוש ב-SDF ובממשק המשתמש. |
exchange |
חובה. לא משתנה. הבורסה שממנה הגיעה ההזמנה המובטחת. |
guaranteedOrderId |
פלט בלבד. המזהה הייחודי של ההזמנה המובטחת. מזהי ההזמנות המובטחים מופיעים בפורמט |
displayName |
חובה. השם המוצג של ההזמנה המובטחת. חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים. |
status |
הגדרות הסטטוס של ההזמנה המובטחת. |
updateTime |
פלט בלבד. חותמת הזמן של מועד העדכון האחרון של ההזמנה המובטחת. הוקצה על ידי המערכת. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
publisherName |
חובה. שם המפרסם של ההזמנה המובטחת. חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים. |
readAccessInherited |
האם לכל המפרסמים של |
readAdvertiserIds[] |
המזהים של המפרסמים שיש להם גישת קריאה להזמנה שהובטחה. אם הוגדר שדה זה, אין לכלול את המפרסם שהוקצה לו |
defaultAdvertiserId |
פלט בלבד. המזהה של מפרסם ברירת המחדל של ההזמנה המובטחת. מפרסם ברירת המחדל הוא |
defaultCampaignId |
המזהה של קמפיין ברירת המחדל שהוקצה להזמנה המובטחת. קמפיין ברירת המחדל חייב להשתייך למפרסם ברירת המחדל. |
שדה איחוד השותף או המפרסם עם גישת קריאה/כתיבה להזמנה המובטחת. הערך של |
|
readWritePartnerId |
השותף עם גישת קריאה/כתיבה להזמנה המובטחת. |
readWriteAdvertiserId |
המפרסם עם גישת קריאה/כתיבה להזמנה המובטחת. זהו גם מפרסם ברירת המחדל של ההזמנה המובטחת. |
GuaranteedOrderStatus
הגדרות הסטטוס של ההזמנה המובטחת.
ייצוג JSON |
---|
{ "entityStatus": enum ( |
שדות | |
---|---|
entityStatus |
האם ההזמנה המובטחת ניתנת להצגה. הערכים הקבילים הם |
entityPauseReason |
הסיבה שסיפק המשתמש להשהיית ההזמנה המובטחת. חייב להיות בקידוד UTF-8 באורך מקסימלי של 100 בייטים. רלוונטי רק אם הערך בשדה |
configStatus |
פלט בלבד. סטטוס ההגדרה של ההזמנה המובטחת. הערכים הקבילים הם כדי שאפשר יהיה להציג את המודעות, צריך להגדיר סדר מובטח (יש למלא את שדות החובה, לבחור נכסי קריאייטיב ולבחור קמפיין ברירת מחדל). בשלב זה ניתן לבצע את פעולת ההגדרה רק דרך ממשק המשתמש. |
GuaranteedOrderConfigStatus
מצבי הגדרה אפשריים להזמנה מובטחת.
טיפוסים בני מנייה (enums) | |
---|---|
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED |
סטטוס האישור לא צוין או שהוא לא ידוע בגרסה הזו. |
PENDING |
המצב ההתחלתי של הזמנה מובטחת. כדי שניתן יהיה להציג את המודעות, צריך להגדיר את ההזמנה המובטחת במצב הזה. |
COMPLETED |
המצב שאחרי שהקונה מגדיר הזמנה מובטחת. |
שיטות |
|
---|---|
|
יצירת הזמנה חדשה עם התחייבות. |
|
העריכות מאפשרות לקרוא מפרסמים של הזמנה מובטחת. |
|
קבלת הזמנה עם התחייבות. |
|
בתיבת הדו שיח הזו רשומים הזמנות עם התחייבות שיש למשתמש הנוכחי גישה אליהן. |
|
עדכון הזמנה קיימת עם התחייבות. |