빠른 개발을 위해 Google 어시스턴트 SDK와 함께 제공되는 등록 도구를 사용하여 기기 모델 및 인스턴스를 빠르게 등록하거나 업데이트할 수 있습니다.
이 도구를 사용하지 않으려면 JSON 파일 및 REST API를 사용하여 수동으로 기기를 등록하거나 업데이트할 수 있습니다. 이 작업은 모든 컴퓨터에서 할 수 있습니다. 먼저 액세스 토큰을 가져오고 해당 섹션으로 건너뜁니다.
액세스 토큰 가져오기
승인 도구가 최신 상태인지 확인합니다.
python -m pip install --upgrade google-auth-oauthlib[tool]
새 기기 모델을 등록할 수 있도록 사용자 인증 정보를 가져옵니다. 이전 단계.
google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \ --headless --client-secrets /path/to/client_secret_client-id.json
터미널에 URL이 표시됩니다.
Please visit this URL to authorize this application: https://...
URL을 복사하여 브라우저에 붙여넣습니다. 이 작업은 개발 머신 또는 다른 머신에서 수행할 수 있습니다. 승인하면 브라우저에 '4/XXXX'와 같은 코드가 표시됩니다. 이 코드를 복사하여 터미널에 붙여넣습니다.
Enter the authorization code:
승인이 성공하면 다음과 비슷한 JSON 응답이 표시됩니다.
{ "scopes": ["https://www.googleapis.com/auth/assistant-sdk-prototype"], "token_uri": "https://accounts.google.com/o/oauth2/token", "token": "ya29.GlujBLa_kuXZ5GnGBPBe_A6NpczLcpOtglEC0wHVORnmEhHETzlSW", "client_id": "795595571889-6iesr9a3nkmnipbdfnqi6gehiklm2m28.apps.googleusercontent.com", "client_secret": "Un8_TNFnb55555auSAGasvAg", "refresh_token": "1/4ZMBhTR3bTYWVEMatYWLOxW755555hlQXZI5uC02F2U" }
대신
UNAUTHENTICATED
이 표시되면 잘못된 코드가 입력된 것입니다. 전체 코드를 복사하여 붙여넣어서 다시 시도하세요.JSON 응답에서
token
을 찾습니다. 이 액세스 토큰 (큰따옴표 제외)을 환경 변수에 복사합니다.ACCESSTOKEN=access-token
기기 모델 작업
기기 모델 정의 및 등록
파일을 만듭니다 (예:
device_model.json
)이 있어야 합니다. 자세한 내용은 기기 모델 JSON 참조를 확인하세요.다음 방법 중 하나를 사용하여 기기 모델을 등록합니다. 아래 URL에서 기기 모델과 연결된
project_id
를 대체해야 합니다.다음 명령을 사용하세요.
curl -s -X POST -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" -d @device_model.json \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/
다음 속성을 사용하여 HTTPS 요청을 전송합니다.
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/
- 메서드:
POST
- 본문:
device_model.json
의 콘텐츠 - 헤더:
Authorization: Bearer <access-token>
여기서 <access-token>은 액세스 토큰이 포함된 문자열입니다.
두 방법 모두 서버는 개발자가 전송한 기기 모델 JSON의 사본을 반환해야 합니다. 모델이 서버에 이미 있는 경우
ALREADY_EXISTS
오류가 발생합니다.
기기 모델 가져오기
다음 방법 중 하나를 사용하여 기기 모델을 가져옵니다. 아래 URL에서 기기 모델과 연결된 project_id
및 device_model_id
를 대체해야 합니다.
다음 명령을 사용하세요.
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/device_model_id
다음 속성을 사용하여 HTTPS 요청을 전송합니다.
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- 메서드:
GET
- 본문: 없음
- 헤더:
Authorization: Bearer <access-token>
여기서 <access-token>은 액세스 토큰이 포함된 문자열입니다.
기기 모델 나열
다음 방법 중 하나를 사용하여 주어진 프로젝트의 모든 기기 모델을 나열합니다. 아래 URL에서 기기 모델과 연결된 project_id
를 대체해야 합니다.
다음 명령을 사용하세요.
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/
다음 속성을 사용하여 HTTPS 요청을 전송합니다.
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/
- 메서드:
GET
- 본문: 없음
- 헤더:
Authorization: Bearer <access-token>
여기서 <access-token>은 액세스 토큰이 포함된 문자열입니다.
기기 모델 업데이트
다음 방법 중 하나를 사용하여 기기 모델을 업데이트합니다. 기기 모델과 연결된 project_id
및 device_model_id
를 대체해야 합니다.
다음 명령을 사용하세요.
curl -s -X PUT -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" -d @device_model.json \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/device_model_id
다음 속성을 사용하여 HTTPS 요청을 전송합니다.
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- 메서드:
PUT
- 본문:
device_model.json
의 콘텐츠 - 헤더:
Authorization: Bearer <access-token>
여기서 <access-token>은 액세스 토큰이 포함된 문자열입니다.
두 방법 모두 서버는 개발자가 전송한 업데이트된 기기 모델 JSON의 사본을 반환해야 합니다.
기기 모델 삭제
다음 방법 중 하나를 사용하여 기기 모델을 삭제합니다. 아래 URL에서 기기 모델과 연결된 project_id
및 device_model_id
를 대체해야 합니다.
다음 명령을 사용하세요.
curl -s -X DELETE -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/device_model_id
다음 속성을 사용하여 HTTPS 요청을 전송합니다.
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- 메서드:
DELETE
- 본문: 없음
- 헤더:
Authorization: Bearer <access-token>
여기서 <access-token>은 액세스 토큰이 포함된 문자열입니다.
기기 인스턴스 작업
기기 인스턴스 정의 및 등록
파일을 만듭니다 (예:
test_device.json
)입니다. 자세한 내용은 기기 인스턴스 JSON 참조를 확인하세요.다음 방법 중 하나를 사용하여 기기를 등록합니다. 아래 URL에서 기기 모델과 연결된
project_id
를 대체해야 합니다.다음 명령을 사용하세요.
curl -s -X POST -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" -d @test_device.json \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/
다음 속성을 사용하여 HTTPS 요청을 전송합니다.
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/
- 메서드:
POST
- 본문:
test_device.json
의 콘텐츠 - 헤더:
Authorization: Bearer <access-token>
여기서 <access-token>은 액세스 토큰이 포함된 문자열입니다.
두 방법 모두 서버는 개발자가 전송한 기기 인스턴스 JSON의 사본을 반환해야 합니다. 인스턴스가 이미 서버에 있는 경우
ALREADY_EXISTS
오류가 수신됩니다.
기기 인스턴스 가져오기
다음 방법 중 하나를 사용하여 기기 인스턴스를 가져옵니다. 아래 URL에서 기기 모델 및 기기 id
와 연결된 project_id
를 대체해야 합니다.
다음 명령을 사용하세요.
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/id
다음 속성을 사용하여 HTTPS 요청을 전송합니다.
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/<id>
- 메서드:
GET
- 본문: 없음
- 헤더:
Authorization: Bearer <access-token>
여기서 <access-token>은 액세스 토큰이 포함된 문자열입니다.
기기 인스턴스 나열
다음 방법 중 하나를 사용하여 지정된 프로젝트의 모든 기기 인스턴스를 나열합니다. 아래 URL의 기기 인스턴스와 연결된 project_id
를 대체해야 합니다.
다음 명령을 사용하세요.
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/
다음 속성을 사용하여 HTTPS 요청을 전송합니다.
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/
- 메서드:
GET
- 본문: 없음
- 헤더:
Authorization: Bearer <access-token>
여기서 <access-token>은 액세스 토큰이 포함된 문자열입니다.
기기 인스턴스 삭제
다음 방법 중 하나를 사용하여 기기 인스턴스를 삭제합니다. 아래 URL에서 기기 모델 및 기기 id
와 연결된 project_id
를 대체해야 합니다.
다음 명령을 사용하세요.
curl -s -X DELETE -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/id
다음 속성을 사용하여 HTTPS 요청을 전송합니다.
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/<id>
- 메서드:
DELETE
- 본문: 없음
- 헤더:
Authorization: Bearer <access-token>
여기서 <access-token>은 액세스 토큰이 포함된 문자열입니다.