- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- ExtendedServiceAvailability
Remplace la valeur Availability
de Services
existants. Cet appel par lot ne garantit pas l'atomicité. Seuls les créneaux de disponibilité mis à jour sont renvoyés.
Requête HTTP
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*}/availability:replace
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
parent |
Format |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{
"extendedServiceAvailability": [
{
object ( |
Champs | |
---|---|
extendedServiceAvailability[] |
Disponibilité étendue du service utilisée pour remplacer les créneaux de disponibilité existants. |
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient des données présentant la structure suivante :
Réponse par lot pour remplacer plusieurs créneaux de disponibilité du Service
. Seuls les créneaux mis à jour sont inclus dans ce message.
Représentation JSON |
---|
{
"extendedServiceAvailability": [
{
object ( |
Champs | |
---|---|
extendedServiceAvailability[] |
Messages bien mis à jour concernant la disponibilité étendue du service qui ont été utilisés pour remplacer les créneaux de disponibilité existants. |
Champs d'application des autorisations
Requiert le champ d'application OAuth suivant :
https://www.googleapis.com/auth/mapsbooking
ExtendedServiceAvailability
Liste de disponibilités et à qui/quand les appliquer
Représentation JSON |
---|
{ "merchantId": string, "serviceId": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { object ( |
Champs | |
---|---|
merchantId |
Ce champ obligatoire permet d'indiquer à quel marchand appartiennent les messages de disponibilité ci-dessous. |
serviceId |
Ce champ obligatoire permet d'indiquer à quel service appartiennent les messages de disponibilité ci-dessous. |
startTimeRestrict |
Nous traitons les entités de disponibilité éventuellement fournies comme un instantané complet de [startTimeRestrict, endTimeRestrict). Autrement dit, le système supprime toute disponibilité existante si la condition suivante est remplie :
Si un message "duration" (durée) est défini, la condition est encore plus exigeante :
Si un message "resourcesRestrict" est défini, la condition est plus exigeante encore :
Ces champs sont généralement utilisés pour fournir une mise à jour complète de la disponibilité pour une période donnée. Si vous définissez la valeur startTimeRestrict, mais pas la valeur endTimeRestrict, le système en conclut que toutes les heures commencent à startTimeRestrict. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
endTimeRestrict |
Si vous définissez la valeur endTimeRestrict, mais pas la valeur startTimeRestrict, le système en conclut que toutes les heures sont incluses jusqu'à la fin de endTimeRestrict. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
durationRestrict |
Lorsque la durée est définie, toute mise à jour de la disponibilité est limitée aux créneaux de cette durée. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
resourcesRestrict |
Lorsque resourcesRestrict est défini, toute mise à jour est limitée à cet ensemble de ressources seulement. Tous les champs des identifiants de ressources doivent correspondre exactement. |
availability[] |
Nouvelle liste de disponibilités. |