Method: inventory.partners.merchants.services.availability.replace

Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut Service için Availability değerini değiştirir ve geri döndürür.

HTTP isteği

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{serviceAvailability.name=partners/*/merchants/*/services/*}/availability:replace

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
serviceAvailability.name

string

Bunun uygulanacağı hizmetin kaynak adı. partners/{partner_id}/merchants/{merchantId}/services/{serviceId} biçiminde

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "serviceAvailability": {
    "name": string,
    "startTimeRestrict": string,
    "endTimeRestrict": string,
    "durationRestrict": string,
    "resourcesRestrict": {
      "staffId": string,
      "staffName": string,
      "roomId": string,
      "roomName": string,
      "partySize": integer
    },
    "availability": [
      {
        "startTime": string,
        "duration": string,
        "spotsTotal": string,
        "spotsOpen": string,
        "availabilityTag": string,
        "resources": {
          object (Resources)
        },
        "paymentOptionId": [
          string
        ],
        "recurrence": {
          object (Recurrence)
        },
        "scheduleException": [
          {
            object (ScheduleException)
          }
        ],
        "deposit": {
          object (Deposit)
        },
        "noShowFee": {
          object (NoShowFee)
        },
        "requireCreditCard": enum (RequireCreditCard),
        "ticketTypeId": [
          string
        ],
        "durationRequirement": enum (DurationRequirement),
        "schedulingRuleOverrides": {
          object (SchedulingRuleOverrides)
        },
        "confirmationMode": enum (ConfirmationMode)
      }
    ]
  }
}
Alanlar
serviceAvailability.startTimeRestrict

string (Timestamp format)

Sağlanması durumunda, sağlanan Müsaitlik Durumu varlıklarını [startTimeRestrict, endTimeRestrict öğesinde eksiksiz bir anlık görüntü olarak kabul ederiz. Yani aşağıdaki koşul doğruysa mevcut tüm kullanılabilirlikler silinir:

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

Bir süre mesajı ayarlanırsa koşul daha da kısıtlanır:

  availability.duration == durationRestrict

Kaynakları kısıtla mesajı ayarlanırsa koşul daha da kısıtlanır:

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

Bu alanlar genellikle belirli bir zaman aralığındaki kullanılabilirliğin tam bir güncellemesini sağlamak için kullanılır.

endTimeRestrict ayarlanmadan bırakılırsa startTimeRestrict ayarı, startTimeRestrict ile başlayan tüm zamanlar anlamına gelecek şekilde yorumlanır.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
serviceAvailability.endTimeRestrict

string (Timestamp format)

startTimeRestrict ayarlanmadan bırakılırsa endTimeRestrict ayarı, endTimeRestrict değerine kadar olan tüm zamanlar anlamına gelecek şekilde yorumlanır.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
serviceAvailability.durationRestrict

string (Duration format)

Sürenin ayarlanması, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlik durumuyla daha da kısıtlar.

En fazla dokuz kesir basamağı içeren ve "s" ile biten saniye cinsinden bir süre. Örnek: "3.5s".
serviceAvailability.resourcesRestrict

object (Resources)

"Kaynakları kısıtla"yı ayarlamak, güncellemenin kapsamını yalnızca bu kaynak grubuyla daha da kısıtlar. Kaynakların tüm kimlik alanları tam olarak eşleşmelidir.
serviceAvailability.availability[]

object (Availability)

Yeni kullanılabilirlik listesi.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Kullanılabilirlik listesi ve kime/ne zaman uygulanacağını gösteren liste.

JSON gösterimi 
{
  "name": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
Alanlar
name

string

Bunun uygulanacağı hizmetin kaynak adı. partners/{partner_id}/merchants/{merchantId}/services/{serviceId} biçiminde
startTimeRestrict

string (Timestamp format)

Sağlanması durumunda, sağlanan Müsaitlik Durumu varlıklarını [startTimeRestrict, endTimeRestrict öğesinde eksiksiz bir anlık görüntü olarak kabul ederiz. Yani aşağıdaki koşul doğruysa mevcut tüm kullanılabilirlikler silinir:

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

Bir süre mesajı ayarlanırsa koşul daha da kısıtlanır:

  availability.duration == durationRestrict

Kaynakları kısıtla mesajı ayarlanırsa koşul daha da kısıtlanır:

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

Bu alanlar genellikle belirli bir zaman aralığındaki kullanılabilirliğin tam bir güncellemesini sağlamak için kullanılır.

endTimeRestrict ayarlanmadan bırakılırsa startTimeRestrict ayarı, startTimeRestrict ile başlayan tüm zamanlar anlamına gelecek şekilde yorumlanır.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
endTimeRestrict

string (Timestamp format)

startTimeRestrict ayarlanmadan bırakılırsa endTimeRestrict ayarı, endTimeRestrict değerine kadar olan tüm zamanlar anlamına gelecek şekilde yorumlanır.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
durationRestrict

string (Duration format)

Sürenin ayarlanması, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlik durumuyla daha da kısıtlar.

En fazla dokuz kesir basamağı içeren ve "s" ile biten saniye cinsinden bir süre. Örnek: "3.5s".
resourcesRestrict

object (Resources)

"Kaynakları kısıtla"yı ayarlamak, güncellemenin kapsamını yalnızca bu kaynak grubuyla daha da kısıtlar. Kaynakların tüm kimlik alanları tam olarak eşleşmelidir.
availability[]

object (Availability)

Yeni kullanılabilirlik listesi.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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