Method: inventory.partners.feeds.record.batchPush

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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

לפידים מבוססי-proto.

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