ARCore 클라우드 앵커를 사용하여 ARCore 앱 외부의 클라우드 앵커 관리 관리 API
시작하기
작업 예
승인
서비스 계정 키 만들기 Google Cloud Platform 콘솔로 이동하여 클라우드 앵커 관리 API 호출을 승인하는 OAuth2 토큰
탐색 메뉴에서 Google Cloud Platform 콘솔에서 APIs & Services > Credentials입니다.
원하는 프로젝트를 선택한 후 Create Credentials 아이콘을 클릭합니다. Service account
Service account details 아래에 새 계정의 이름을 입력합니다. Create를 클릭합니다.
Service account permissions 페이지에서 Select a role(으)로 이동합니다. 선택합니다. Service Accounts 선택 > Service Account Token Creator, Continue를 클릭합니다.
Grant users access to this service account 페이지에서 Done를 클릭합니다. 그러면 APIs & Services(으)로 돌아갑니다. > Credentials
Credentials 페이지에서 Service Accounts 섹션까지 아래로 스크롤합니다. 방금 만든 계정의 이름을 클릭합니다.
Service account details 페이지에서 Keys 섹션까지 아래로 스크롤합니다. 그런 다음 Add Key > Create new key입니다.
키 유형으로 JSON를 선택하고 Create를 클릭합니다. 이렇게 하면 JSON이 다운로드됩니다. 개인 키가 포함된 파일을 머신에 업로드합니다. 다운로드한 JSON 저장 키 파일을 안전한 위치에 보관해야 합니다.
OAuth2 토큰 생성
arcore.management은 Cloud Anchors Management API의 OAuth 범위입니다. 작성자:
기본적으로 oauth2l은 토큰 캐시에서 작동합니다. fetch 명령어는
토큰입니다. oauth2l을 사용하여 OAuth2 생성
승인용 토큰:
oauth2l fetch --json creds.json arcore.management
새 토큰을 생성하려면 --cache="" 옵션을 fetch에 추가합니다.
명령어와 함께 사용하면 됩니다
oauth2l fetch --cache="" --json creds.json arcore.management
또는 oauth2l reset를 호출하고 fetch 명령어를 다시 호출합니다.
oauth2l resetoauth2l fetch --json creds.json arcore.management
모든 클라우드 앵커 나열
클라우드 앵커의 첫 페이지를 가져옵니다. 원하는 경우 expire_time 기준으로 정렬됩니다.
create_time 또는 last_localize_time입니다.
요청:
export BEARER_TOKEN=`(oauth2l fetch --json creds.json arcore.management)`curl -H "Authorization: Bearer $BEARER_TOKEN" \
"https://arcore.googleapis.com/v1beta2/management/anchors?page_size=50&order_by=last_localize_time%20desc"
대답:
{
"anchors": [
{
"name": "anchors/ua-a1cc84e4f11b1287d289646811bf54d1",
"createTime": "...",
"expireTime": "...",
"lastLocalizeTime": "...",
"maximumExpireTime": "..."
},
…
{
"name": "anchors/ua-41a3d0233471917875159f6f3c25ea0e",
"createTime": "...",
"expireTime": "...",
"lastLocalizeTime": "...",
"maximumExpireTime": "..."
}
],
nextPageToken: "some-long-string"
}
응답이 nextPageToken로 돌아오면
목록. 다음 요청에서 next_page_token 쿼리 매개변수를 사용하여
확인할 수 있습니다.
요청:
curl -H "Authorization: Bearer $BEARER_TOKEN" \
"https://arcore.googleapis.com/v1beta2/management/anchors?page_size=50&order_by=last_localize_time%20desc&next_page_token=your-next-page-token-here"
next_page_token를 사용할 때는 page_size 및 order_by가 일관되어야 합니다.
전체 요청 수에 따라 달라집니다 page_size의 기본값은 1000이고 order_by의 기본값은 다음과 같습니다.
expire_time_desc입니다.
클라우드 앵커의 TTL(수명)을 허용되는 최대 시간으로 업데이트
단일 클라우드 앵커를 요청하여 lastLocalizeTime 및
maximumExpireTime
요청:
export BEARER_TOKEN=`(oauth2l fetch --json creds.json arcore.management)`curl -H "Authorization: Bearer $BEARER_TOKEN" \
"https://arcore.googleapis.com/v1beta2/management/anchors/your-anchor-id-here"
대답:
{
"name": "anchors/ua-f21be53fd8ea57f0169c69fbf827f6b7",
"createTime": "2020-06-29T21:00:00Z",
"expireTime": "2020-08-28T22:00:00Z",
"lastLocalizeTime": "2020-06-29T21:00:00Z",
"maximumExpireTime": "2021-06-29T21:00:00Z"
}
앵커가 있으면 expireTime를 maximumExpireTime로 업데이트합니다.
요청:
curl -H "Authorization: Bearer $BEARER_TOKEN" -H "Content-Type: application/json" -X "PATCH" \
"https://arcore.googleapis.com/v1beta2/management/anchors/your-anchor-id-here?updateMask=expire_time" \
-d '{ expireTime: "2021-06-29T21:00:00Z" }'
대답:
{
"name": "anchors/ua-f21be53fd8ea57f0169c69fbf827f6b7",
"createTime": "2020-06-29T21:00:00Z",
"expireTime": "2021-06-29T21:00:00Z",
"lastLocalizeTime": "2020-06-29T21:00:00Z",
"maximumExpireTime": "2021-06-29T21:00:00Z"
}
클라우드 앵커 삭제
단일 클라우드 앵커를 삭제합니다.
export BEARER_TOKEN=`(oauth2l fetch --json creds.json arcore.management)`curl -H "Authorization: Bearer $BEARER_TOKEN" -X "DELETE" \
"https://arcore.googleapis.com/v1beta2/management/anchors/your-anchor-id-here"
클라우드 앵커 배치를 삭제합니다.
export BEARER_TOKEN=`(oauth2l fetch --json creds.json arcore.management)`curl -H "Authorization: Bearer $BEARER_TOKEN" -H "Content-Type: application/json" -X "POST" \
"https://arcore.googleapis.com/v1beta2/management/anchors:batchDelete" \
-d '{ names: [ "anchors/your-anchor-id-here", "anchors/your-anchor-id-here" ]}'