Method: inventory.partners.feeds.record.batchPush

Wstawia lub aktualizuje rekordy określonego typu pliku danych. Przeprowadza tylko podstawową weryfikację (np. czy żądanie nie jest zniekształcone), po czym natychmiast zwraca partnerowi odpowiednią odpowiedź. Google asynchronicznie przeprowadza weryfikację logiki biznesowej żądania. To wywołanie pakietowe nie gwarantuje atomowości.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Nazwa zasobu w formacie partners/{partner_id}/feeds/{feed_name}.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "records": [
    {
      object (GenericRecord)
    }
  ]
}
Pola
records[]

object (GenericRecord)

Rekordy do wstawienia lub zaktualizowania. W jednym wywołaniu interfejsu API można przesłać maksymalnie 1000 rekordów.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie pustym obiektem JSON.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

GenericRecord

Zapis typu pliku danych wspomnianego w żądaniu adresu URL.

Zapis 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.
}
Pola
generationTimestamp

string (Timestamp format)

Wymagane. Ta sygnatura czasowa służy do zapewnienia prawidłowej kolejności aktualizacji asortymentu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
Pole zbiorcze record_type. enkapsulować różne typy plików danych (ndjson, proto-based itp.); record_type może mieć tylko jedną z tych wartości:
dataRecord

string (bytes format)

W przypadku plików danych nieopartych na protokole.

Ciąg zakodowany w formacie Base64.
protoRecord

object

W przypadku plików danych opartych na protokole.

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI określający typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }