Method: inventory.partners.availability.replace

기존 Services의 Availability를 대체합니다. 이러한 일괄 호출이 원자성을 보장하지 않습니다. 성공적으로 업데이트된 이용 가능 시간대만 반환됩니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

partners/{partner_id} 형식입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
필드
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

기존 이용 가능 시간대를 대체하는 데 사용되는 확장된 서비스 이용 가능 시간대입니다.

응답 본문

요청이 성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.

여러 Service의 이용 가능 시간대를 대체하기 위한 일괄 응답입니다. 성공적으로 업데이트된 시간대만 이 메시지에 포함됩니다.

JSON 표현 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
필드
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

성공적으로 업데이트된 확장된 서비스 이용 가능 시간대로, 기존 이용 가능 시간대를 대체합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

ExtendedServiceAvailability

이용 가능 여부 및 적용 대상/시기의 목록입니다.

JSON 표현 
{
  "merchantId": string,
  "serviceId": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
필드
merchantId

string

아래의 이용 가능 여부 메시지가 속한 판매자를 지정하는 데 필요한 필수 필드입니다.
serviceId

string

아래의 이용 가능 여부 메시지가 속한 서비스를 지정하는 데 필요한 필수 필드입니다.
startTimeRestrict

string (Timestamp format)

이 필드를 지정하면 제공된 이용 가능 여부 항목이 [startTimeRestrict, endTimeRestrict]의 전체 스냅샷으로 간주됩니다. 즉 다음 조건이 참이면 기존의 이용 가능 여부가 모두 삭제됩니다.

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

duration 메시지가 설정되면 조건이 추가로 제한됩니다.

  availability.duration == durationRestrict

resourcesRestrict 메시지가 설정되면 조건이 추가로 제한됩니다.

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

이 필드는 일반적으로 지정된 기간의 이용 가능 여부를 완전히 업데이트하는 데 사용됩니다.

startTimeRestrict를 설정하고 endTimeRestrict를 설정하지 않으면 startTimeRestrict에서 시작하는 모든 시간을 의미하는 것으로 해석됩니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
endTimeRestrict

string (Timestamp format)

endTimeRestrict를 설정하고 startTimeRestrict를 설정하지 않으면 endTimeRestrict까지의 모든 시간을 의미하는 것으로 해석됩니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
durationRestrict

string (Duration format)

duration을 설정하면 업데이트 범위가 일치하는 기간의 이용 가능 여부로만 제한됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
resourcesRestrict

object (Resources)

resourceRestrict를 설정하면 업데이트 범위가 이 리소스 집합으로만 추가로 제한됩니다. 리소스의 모든 ID 필드가 정확히 일치해야 합니다.
availability[]

object (Availability)

새로운 이용 가능 여부 목록입니다.