Method: inventory.partners.feeds.record.batchPush

Menyisipkan dan/atau memperbarui data jenis feed yang ditentukan. Hanya melakukan validasi dasar (seperti permintaan yang salah format), lalu respons yang sesuai akan segera dikirimkan kepada partner. Google melakukan validasi logika bisnis pada permintaan secara asinkron. Panggilan batch ini tidak menjamin atomicity.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Nama resource, yang memiliki format - partners/{partner_id}/feeds/{feed_name}.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "records": [
    {
      object (GenericRecord)
    }
  ]
}
Kolom
records[]

object (GenericRecord)

Data yang akan disisipkan dan/atau diperbarui. Maksimum 1.000 data diizinkan dalam satu panggilan API.

Isi respons

Jika berhasil, isi respons adalah objek JSON kosong.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

GenericRecord

Mencatat jenis feed yang disebutkan dalam permintaan URL.

Representasi 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.
}
Kolom
generationTimestamp

string (Timestamp format)

Wajib. Stempel waktu ini digunakan untuk memastikan urutan update inventaris yang benar.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Kolom union record_type. Mengenkapsulasi berbagai jenis feed (berbasis proto, ndjson, dll.) record_type hanya dapat berupa salah satu dari berikut:
dataRecord

string (bytes format)

Untuk feed berbasis non-proto.

String berenkode base64.

protoRecord

object

Untuk feed berbasis proto.

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.