REST Resource: sellers.availabilityOrders.availabilityLines

משאב: AvailabilityLine

קו זמינות מייצג קבוצה של הגדרות שעבורן הקונה מבקש זמינות מלאי ואת התגובה של בית העסק. לתהליך עבודה אפשר לראות את AvailabilityOrder.

ייצוג JSON
{
  "name": string,
  "product": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "budget": {
    object (Money)
  },
  "targeting": {
    object (Targeting)
  },
  "availabilityLineTerms": {
    object (LineTerms)
  },
  "state": enum (State),
  "rejection": {
    object (Rejection)
  },
  "createTime": string,
  "updateTime": string
}
שדות
name

string

פלט בלבד. שם המשאב של שורת הזמינות בפורמט: sellers/111/availabilityOrders/123/availabilityLines/321.

product

string

פלט בלבד. השם של Product שעבורה מוגשת בקשת הזמינות. פורמט = products/456

startDate

object (Date)

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

endDate

object (Date)

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

budget

object (Money)

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

targeting

object (Targeting)

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

availabilityLineTerms

object (LineTerms)

פלט בלבד. בית העסק יכול להשתמש ב-[Complete][google.ads.xbid.outofhome.v1.OrderManagementService.CompleteAvailabilityLine] כדי לעדכן את [LineTerms].

state

enum (State)

פלט בלבד. המצב של הזמנת הזמינות הזו. כאן אפשר לראות את מחזור החיים של AvailabilityLine ב-AvailabilityLine.State.

בית העסק יכול להשתמש בשיטות המותאמות אישית [Complete][google.ads.xbid.outofhome.v1.OrderManagementService.CompleteAvailabilityLine] או [Reject][google.ads.xbid.outofhome.v1.OrderManagementService.RejectAvailabilityLine] כדי להגדיר לאחת מהאפשרויות הבאות:

  • STATE_COMPLETED
  • STATE_REJECTED

בהתאמה.

rejection

object (Rejection)

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

createTime

string (Timestamp format)

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

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

updateTime

string (Timestamp format)

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

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

מדינה

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

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED ערך ברירת המחדל כאשר מצב שורת הזמינות לא צוין או שאינו ידוע בגרסה הזו.
STATE_PENDING הזמינות בהמתנה כשהקונה סיפק את ההגדרות של בקשת הזמינות.
STATE_COMPLETED הסטטוס 'הושלם' כשבית העסק סיפק את תגובת הזמינות.
STATE_REJECTED מצב הדחייה אם שורת הזמינות נדחתה על ידי בית העסק. יש לספק את פרטי הפסילה.
STATE_CANCELLED מצב מבוטל שבו הקונה מבטל את ההזמנה לפני שבית העסק השלים או דחה את תגובת הזמינות.

שיטות

complete

סימון קו זמינות קיים כבוצעה.

get

אחזור של שורה מסוימת להזמנת זמינות.

list

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

reject

סימון שורת זמינות קיימת כנדחתה.