- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- NewEnrichmentItem
- TextEnrichment
- LocationEnrichment
- 위치
- LatLng
- MapEnrichment
- EnrichmentItem
- 실습
정의된 앨범의 지정된 위치에 보강 항목을 추가합니다.
HTTP 요청
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:addEnrichment
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
albumId |
필수 항목입니다. 보강 항목을 추가할 앨범의 식별자입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "newEnrichmentItem": { object ( |
필드 | |
---|---|
newEnrichmentItem |
필수 항목입니다. 추가할 보강입니다. |
albumPosition |
필수 항목입니다. 앨범에서 보강이 삽입되는 위치입니다. |
응답 본문
생성된 보강 항목입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"enrichmentItem": {
object ( |
필드 | |
---|---|
enrichmentItem |
출력 전용입니다. 보강이 추가되었습니다. |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.appendonly
https://www.googleapis.com/auth/photoslibrary.sharing
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata
NewEnrichmentItem
앨범에 추가할 새 보강 항목으로, albums.addEnrichment
호출에서 사용됩니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 enrichment . 앨범에 추가할 보강입니다. 텍스트, 위치 또는 지도를 입력할 수 있습니다. enrichment 은 다음 중 하나여야 합니다. |
|
textEnrichment |
앨범에 추가할 텍스트입니다. |
locationEnrichment |
앨범에 추가할 위치입니다. |
mapEnrichment |
앨범에 추가할 지도 |
TextEnrichment
텍스트가 포함된 보강입니다.
JSON 표현 |
---|
{ "text": string } |
필드 | |
---|---|
text |
이 보강 항목의 텍스트입니다. |
LocationEnrichment
단일 위치를 포함하는 보강입니다.
JSON 표현 |
---|
{
"location": {
object ( |
필드 | |
---|---|
location |
이 보강 항목의 위치입니다. |
위치
물리적 위치를 나타냅니다.
JSON 표현 |
---|
{
"locationName": string,
"latlng": {
object ( |
필드 | |
---|---|
locationName |
표시할 위치의 이름입니다. |
latlng |
지도에서 위치의 위치입니다. |
LatLng
위도/경도 쌍을 나타내는 객체로 위도(도)와 경도(도)를 나타내는 double의 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.
JSON 표현 |
---|
{ "latitude": number, "longitude": number } |
필드 | |
---|---|
latitude |
위도입니다. 범위는 [-90.0, +90.0]입니다. |
longitude |
경도입니다. 범위는 [-180.0, +180.0]입니다. |
MapEnrichment
출발지와 목적지 위치를 보여주는 지도가 포함된 보강입니다.
JSON 표현 |
---|
{ "origin": { object ( |
필드 | |
---|---|
origin |
이 보강 항목의 출발지 위치입니다. |
destination |
이 보강 항목의 대상 위치입니다. |
EnrichmentItem
보강 항목입니다.
JSON 표현 |
---|
{ "id": string } |
필드 | |
---|---|
id |
보강 항목의 식별자입니다. |