Method: inventory.partners.feeds.record.batchPush

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

בקשת HTTP

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchPush

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

שם המשאב, בפורמט partners/{partner_id}/feeds/{feed_name}.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "records": [
    {
      object (GenericRecord)
    }
  ]
}
שדות
records[]

object (GenericRecord)

רשומות להוספה ו/או לעדכון. בקריאה אחת ל-API ניתן להשתמש ב-1,000 רשומות לכל היותר.

גוף התגובה

אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/mapsbooking

GenericRecord

תיעוד של סוג הפיד שמוזכר בבקשה לכתובת URL.

ייצוג JSON 
{
  "generationTimestamp": string,

  // Union field record_type can be only one of the following:
  "dataRecord": string,
  "protoRecord": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field record_type.
}
שדות
generationTimestamp

string (Timestamp format)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
שדה איחוד record_type. אנקפסולציה של סוגים שונים של עדכונים (ndjson, מבוסס על פרוטו וכו') הערך של record_type יכול להיות רק אחת מהאפשרויות הבאות:
dataRecord

string (bytes format)

עבור פידים שאינם מבוססים על פרוטו.

מחרוזת בקידוד base64.
protoRecord

object

בפידים שמבוססים על פרוטו.

אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף "@type" מכיל URI שמזהה את הסוג. דוגמה: { "id": 1234, "@type": "types.example.com/standard/id" }