REST Resource: guaranteedOrders

משאב: GuaranteedOrder

הזמנה מובטחת.

הזמנות מובטחות הן ישות הורה של מקורות מלאי שטחי פרסום מובטחים. כשיוצרים מקור של מלאי שטחי פרסום מובטח, צריך להקצות למקור מלאי שטחי הפרסום מזהה הזמנה מובטחת.

ייצוג JSON 
{
  "name": string,
  "legacyGuaranteedOrderId": string,
  "exchange": enum (Exchange),
  "guaranteedOrderId": string,
  "displayName": string,
  "status": {
    object (GuaranteedOrderStatus)
  },
  "updateTime": string,
  "publisherName": string,
  "readAccessInherited": boolean,
  "readAdvertiserIds": [
    string
  ],
  "defaultAdvertiserId": string,
  "defaultCampaignId": string,

  // Union field read_write_accessor can be only one of the following:
  "readWritePartnerId": string,
  "readWriteAdvertiserId": string
  // End of list of possible types for union field read_write_accessor.
}
שדות
name

string

פלט בלבד. שם המשאב של ההזמנה עם ההתחייבות.
legacyGuaranteedOrderId

string

פלט בלבד. המזהה הקודם של ההזמנה עם ההתחייבות. הוקצתה על ידי ההחלפה המקורית. המזהה הקודם הוא ייחודי בתוך המרות מסוימות, אבל אין ערובה שהוא יהיה ייחודי בכל ההזמנות המובטחות. המזהה הזה משמש ב-SDF ובממשק המשתמש.
exchange

enum (Exchange)

חובה. בלתי ניתן לשינוי. פלטפורמת ה-Exchange שממנה הגיעה ההזמנה המובטחת.
guaranteedOrderId

string

פלט בלבד. המזהה הייחודי של ההזמנה עם ההתחייבות. הפורמט של מזהי ההזמנה עם ההתחייבות היא {exchange}-{legacyGuaranteedOrderId}.
displayName

string

חובה. השם המוצג של ההזמנה המובטחת.

חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים.
status

object (GuaranteedOrderStatus)

הגדרות הסטטוס של ההזמנה עם ההתחייבות למשלוח מהיר.
updateTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של העדכון האחרון של ההזמנה עם ההתחייבות למחיר הנמוך ביותר. המערכת מקצה את השם.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
publisherName

string

חובה. שם המוציא לאור של ההזמנה המובטחת.

חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים.
readAccessInherited

boolean

האם לכל המפרסמים של readWritePartnerId יש גישת קריאה להזמנה המובטחת. רלוונטי רק אם readWritePartnerId מוגדר. אם הערך הוא True, הוא מבטל את הערך של readAdvertiserIds.
readAdvertiserIds[]

string (int64 format)

המזהים של המפרסמים שיש להם גישת קריאה להזמנה עם ההתחייבות.

אם השדה הזה מוגדר, אסור לכלול בו את המפרסם שהוקצה ל-readWriteAdvertiserId. כל המפרסמים בשדה הזה חייבים להשתייך ל-readWritePartnerId או לאותו שותף כמו readWriteAdvertiserId.
defaultAdvertiserId

string (int64 format)

פלט בלבד. המזהה של מפרסם ברירת המחדל של ההזמנה המובטחת.

מפרסם ברירת המחדל הוא readWriteAdvertiserId, או, אם לא הוגדר, המפרסם הראשון שרשום בreadAdvertiserIds. אחרת, לא יהיה מפרסם ברירת מחדל.
defaultCampaignId

string (int64 format)

המזהה של קמפיין ברירת המחדל שהוקצה להזמנה המובטחת.

קמפיין ברירת המחדל חייב להיות שייך למפרסם ברירת המחדל.

שדה איחוד read_write_accessor. חובה.

השותף או המפרסם עם גישת קריאה/כתיבה להזמנה המובטחת. read_write_accessor יכול להיות רק אחת מהאפשרויות הבאות:
readWritePartnerId

string (int64 format)

השותף שיש לו גישת קריאה/כתיבה להזמנה המובטחת.
readWriteAdvertiserId

string (int64 format)

המפרסם עם גישת קריאה/כתיבה להזמנה המובטחת. זהו גם המפרסם שמוגדר כברירת מחדל בהזמנה המובטחת.

GuaranteedOrderStatus

הגדרות הסטטוס של ההזמנה עם ההתחייבות למשלוח מהיר.

ייצוג JSON 
{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "configStatus": enum (GuaranteedOrderConfigStatus)
}
שדות
entityStatus

enum (EntityStatus)

האם אפשר להציג את ההזמנה עם ההתחייבות למחיר הנמוך ביותר.

הערכים הקבילים הם ENTITY_STATUS_ACTIVE,‏ ENTITY_STATUS_ARCHIVED ו-ENTITY_STATUS_PAUSED. ערך ברירת המחדל הוא ENTITY_STATUS_ACTIVE.
entityPauseReason

string

הסיבה שהמשתמש סיפק להשהיית ההזמנה עם ההתחייבות הזו.

חייב להיות בקידוד UTF-8 ובאורך מקסימלי של 100 בייטים.

רלוונטי רק כאשר בשדה entityStatus מוגדר הערך ENTITY_STATUS_PAUSED.
configStatus

enum (GuaranteedOrderConfigStatus)

פלט בלבד. סטטוס ההגדרה של ההזמנה עם ההתחייבות.

הערכים הקבילים הם PENDING ו-COMPLETED.

כדי שאפשר יהיה להציג את ההזמנה, צריך להגדיר אותה (למלא את השדות הנדרשים, לבחור נכסי קריאייטיב ולבחור קמפיין ברירת מחדל). בשלב הזה ניתן לבצע את פעולת ההגדרה רק דרך ממשק המשתמש.

GuaranteedOrderConfigStatus

מצבי הגדרה אפשריים להזמנה מובטחת.

טיפוסים בני מנייה (enum)
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED סטטוס האישור לא צוין או לא ידוע בגרסה הזו.
PENDING המצב ההתחלתי של הזמנה מובטחת. כדי להציג את המודעות, צריך להגדיר את ההזמנה עם ההתחייבות במצב הזה.
COMPLETED המצב שאחרי הקונה מגדיר הזמנה מובטחת.

שיטות

create

 יצירת הזמנה חדשה עם התחייבות.

editGuaranteedOrderReadAccessors

 עריכות קוראות למפרסמים של הזמנה מובטחת.

get

 מקבל הזמנה מובטחת.

list

 רשימה של הזמנות מובטחות שזמינות למשתמש הנוכחי.

patch

 עדכון של הזמנה מובטחת קיימת.