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)

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