이벤트 리소스의 필드 가장 일반적인 데이터와 이벤트(예: 위치, 시작 시간)를 저장하지만, 애플리케이션은 추가 메타데이터를 제공합니다. Calendar API는 이벤트로 숨겨진 키-값 쌍을 설정하는 기능 확장 속성입니다. 확장 속성을 사용하면 이벤트의 애플리케이션별 데이터를 쉽게 저장할 수 있습니다. 애플리케이션을 실행할 수 있습니다
공개 상태
확장 속성에는 비공개와 공유라는 두 가지 유형의 확장 속성을 사용할 수 있습니다.
공유 속성은 이벤트의 모든 참석자가 보고 수정할 수 있지만,
사유지가 한 참석자의 로컬 '사본'에 설정되어 있음 있습니다. 더보기
구체적으로 비공개 부동산은 calendarId
및 eventId
에만 한정됩니다.
는 요청에 포함되지만 공유 속성은
요청에 calendarId
가 사용되었습니다.
추가 및 속성 업데이트
확장 속성은 이벤트 리소스에서 설정되며 다른 필드와 마찬가지로 insert에 설정된 경우 update 및 patch 요청 패치 요청을 사용하는 것이 가장 좋음 메서드를 사용하면 다른 속성을 그대로 두고 일부 속성을 조작할 수 있기 때문입니다. 있습니다. 동일한 키로 새 속성을 추가하면 기존 속성을 생성할 수 있습니다. 다음 예는 비공개 설정을 보여줍니다. 속성:
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
{
"extendedProperties": {
"private": {
"petsAllowed": "yes"
}
}
}
속성 삭제
업데이트 요청에 포함되지 않은 속성은 삭제되지만 패치 요청을 하여 값을 null로 설정하는 것입니다. 다음 비공개 속성 삭제를 보여주는 예입니다.
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
{
"extendedProperties": {
"private": {
"petsAllowed": null
}
}
}
검색 속성
다음을 사용하여 확장된 속성의 값을 기준으로 이벤트를 검색할 수 있습니다.
Events.list 요청을 보냅니다.
필드 설정
privateExtendedProperty
또는
sharedExtendedProperty
propertyName=value
형식의 제약 조건으로
이는 각각 비공개 및 공유 속성을 검색합니다. 다음
다음 예는 비공개 속성 petsAllowed=yes
가 있는 이벤트를 반환합니다.
GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events ?privateExtendedProperty=petsAllowed%3Dyes
이 필드를 여러 번 반복할 수 있으며 제약 조건은 OR(OR)로 연결됩니다.
따라서 이벤트가 반환될 제약 조건 중 하나와만 일치하면 됩니다.
다음 예에서는 비공개 속성이 있는 이벤트를 찾습니다.
petsAllowed=yes
또는 isOutside=yes
:
GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events ?privateExtendedProperty=petsAllowed%3Dyes &privateExtendedProperty=isOutside%3Dyes
비공개 속성과 공유 속성의 제약 조건은 함께 AND로 연결된다는 점에 유의하세요.
그러나 이벤트가 반환되려면 두 제약조건 세트 모두와 일치해야 합니다.
다음 예시에서는 비공개 속성이 petsAllowed=yes
인 이벤트를 찾습니다.
및 공개 속성 createdBy=myApp
:
GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events ?privateExtendedProperty=petsAllowed%3Dyes &sharedExtendedProperty=createdBy%3DmyApp
한도
- 속성 키의 최대 크기는 44자(영문 기준)이며 자동으로 삭제됩니다.
- 속성 값의 최대 크기는 1, 024자(영문 기준)이며 자동으로 잘립니다.
- 이벤트에는 최대 300개의 속성을 포함할 수 있으며 크기는 총 32KB까지 가능합니다. (키 크기 + 값 크기) 이러한 300개의 부동산에는 공유 및 비공개가 포함됩니다. 속성, 모든 '사본'에서 있습니다.