Method: inventory.partners.feeds.record.batchPush

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

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
parent

string

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

גוף הבקשה

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

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

object (GenericRecord)

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

גוף התשובה

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

היקפי הרשאות

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

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

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
שדה איחוד record_type. הוספת תמיכה בסוגים שונים של פידים (ndjson, מבוסס-פרוטו וכו') הערך record_type יכול להיות רק אחד מהבאים:
dataRecord

string (bytes format)

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

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

object

לפידים מבוססי-פרוטוקול.

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