Method: inventory.partners.availability.replace

Ersetzt die Verfügbarkeit (Availability) vorhandener Dienstleistungen (Services). Dieser Batch-Aufruf garantiert nicht die Atomarität. Nur erfolgreich aktualisierte verfügbare Slots werden zurückgegeben.

HTTP-Anfrage

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*}/availability:replace

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Format von partners/{partner_id}.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
Felder
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

Die erweiterte Verfügbarkeit der Dienstleistung, mit der die vorhandenen verfügbaren Slots ersetzt werden.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

Die Batch-Antwort zum Ersetzen der verfügbaren Slots mehrerer Dienstleistungen (Service). Nur erfolgreich aktualisierte verfügbare Slots werden zurückgegeben.

JSON-Darstellung
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
Felder
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

Die erfolgreich aktualisierten Nachrichten zur erweiterten Verfügbarkeit der Dienstleistung, mit denen die vorhandenen verfügbaren Slots ersetzt wurden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

ExtendedServiceAvailability

Eine Liste der Verfügbarkeiten und auf wen/wann sie angewendet werden sollen

JSON-Darstellung
{
  "merchantId": string,
  "serviceId": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
Felder
merchantId

string

In diesem Pflichtfeld muss angegeben werden, zu welchem Händler die Verfügbarkeitsnachrichten unten gehören.

serviceId

string

In diesem Pflichtfeld muss angegeben werden, zu welchem Dienst die folgenden Verfügbarkeitsnachrichten gehören.

startTimeRestrict

string (Timestamp format)

Sofern festgelegt, betrachten wir die angegebenen Entitäten für die Verfügbarkeit als vollständige Übersicht von [startTimeRestrict, endTimeRestrict]. Das heißt, alle vorhandenen Verfügbarkeiten werden gelöscht, wenn die folgende Bedingung erfüllt ist:

   startTimeRestrict <= availability.start_sec &&
   availability.start_sec < endTimeRestrict

Wenn eine Nachricht für die Dauer festgelegt ist, wird die Bedingung weiter eingeschränkt:

  availability.duration == durationRestrict

Wenn eine "resourcesRestrict"-Nachricht festgelegt ist, wird die Bedingung weiter eingeschränkt:

   availability.resources.staff_id == resourcesRestrict.staff_id &&
   availability.resources.room_id == resourcesRestrict.room_id

Diese Felder werden normalerweise verwendet, um eine vollständige Aktualisierung der Verfügbarkeiten in einem bestimmten Zeitraum bereitzustellen.

Wenn "startTimeRestrict" festgelegt ist, "endTimeRestrict" aber nicht, wird das als immer ab "startTimeRestrict" ausgelegt.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

endTimeRestrict

string (Timestamp format)

Wenn "endTimeRestrict" festgelegt ist, "startTimeRestrict" aber nicht, wird das als immer bis "endTimeRestrict" ausgelegt.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

durationRestrict

string (Duration format)

Wenn die Dauer festgelegt wird, werden nur die Verfügbarkeiten mit übereinstimmender Dauer aktualisiert.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

resourcesRestrict

object (Resources)

Wenn "resourcesRestrict" festgelegt wird, werden nur die entsprechenden Ressourcen aktualisiert. Die ID-Felder der Ressourcen müssen alle genau übereinstimmen.

availability[]

object (Availability)

Die neue Liste der Verfügbarkeiten.