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)

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

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק.

היקפי הרשאה

נדרש היקף ההרשאות הבא של 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)

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

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

string (bytes format)

בפידים שלא מבוססים על Proto.

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

object

לפידים המבוססים על אב-טיפוס.

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