משאב: AddressdOrder
הזמנה מובטחת.
הזמנות מובטחות הן ישות אם של מקורות מלאי מובטחים. כשיוצרים מקור של מלאי שטחי פרסום מובטח, צריך להקצות מזהה הזמנה מובטח למקור של מלאי שטחי הפרסום.
ייצוג JSON |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
שדות | |
---|---|
name |
פלט בלבד. שם המשאב של ההזמנה המובטחת. |
legacyGuaranteedOrderId |
פלט בלבד. המזהה הקודם של ההזמנה עם התחייבות למחיר הנמוך ביותר. הוקצה על ידי בורסת ה-Exchange המקורית. המזהה הקודם הוא ייחודי במסגרת החלפה אחת, אבל לא מובטח שהוא יהיה ייחודי בכל ההזמנות המובטחות. המזהה הזה משמש ב-SSD ובממשק המשתמש. |
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 |
המצב שאחרי שהקונה מגדיר הזמנה עם התחייבות למחיר הנמוך ביותר. |
שיטות |
|
---|---|
|
יצירה של הזמנה חדשה עם התחייבות למחיר הנמוך ביותר. |
|
עריכות קוראות מפרסמים של הזמנה עם התחייבות למחיר הנמוך ביותר. |
|
מקבל הזמנה עם התחייבות למחיר הנמוך ביותר. |
|
בתיבת הדו-שיח הזו מפורטים הזמנות עם התחייבות למחיר הנמוך ביותר שיש למשתמש הנוכחי גישה אליהן. |
|
עדכון הזמנה קיימת עם התחייבות למחיר הנמוך ביותר. |