기본 요건

다음을 아직 확인하지 않았다면 처음으로 클라이언트 애플리케이션의 코딩을 시작하기 전에 진행해야 합니다.

클라이언트용 프로젝트 만들기

요청을 전송하기 전에 Google에 클라이언트에 대해 알리고 API에 대한 액세스를 활성화해야 합니다. Google API 콘솔을 사용하여 설정 및 API 액세스 정보를 모아 이름을 붙인 프로젝트를 만들고 애플리케이션을 등록하세요.

Android Over The Air API를 사용하려면 먼저 설정 도구를 사용해야 합니다. 이 도구는 Google API 콘솔에서 프로젝트를 만들고, API를 사용 설정하고, 사용자 인증 정보를 만드는 방법을 안내합니다.

프로젝트를 허용 목록에 추가하기

Android Over The Air API는 허용된 프로젝트에서만 사용할 수 있습니다. 프로젝트가 허용 목록에 없는 경우 프로젝트를 사용하려고 하면 404 오류가 발생합니다.

허용 목록에 포함되려면 Google TAM에 이메일을 보내 새 프로젝트 ID를 허용 목록에 추가하세요.

프로젝트 ID는 Cloud 대시보드에서 확인할 수 있습니다. 자세한 내용은 이 도움말 문서를 참조하세요.

프로젝트 ID는 {company}-gota-api-{number} 형식이어야 합니다.

허용 목록에 포함된 후 프로젝트에 Android Over The Air API를 enable하고 액세스에 대한 자세한 내용은 승인 안내 문서를 참조하세요.

제공한 프로젝트 ID로만 Android Over The Air API를 사용할 수 있습니다. 개인 계정을 사용하는 대신 API 사용을 위한 서비스 계정 (승인에 설명된 대로)을 만드는 것이 좋습니다.

Android 무선 업데이트 대시보드 사용해 보기

이 API 문서에서는 개발자가 Android 무선 업데이트 대시보드를 사용해 보고 웹 프로그래밍 개념과 웹 데이터 형식에 익숙하다고 가정합니다.

Android 무선 업데이트 대시보드를 사용해 본 적이 없다면 코딩을 시작하기 전에 사용자 인터페이스를 사용해 보세요.

REST 기본사항 알아보기

API를 호출하는 방법에는 2가지가 있습니다.

클라이언트 라이브러리를 사용하지 않으려는 경우에는 REST의 기본사항을 이해해야 합니다.

REST는 데이터 요청 및 수정에 대한 간편하고 일관성 있는 접근 방식을 제공하는 소프트웨어 아키텍처 스타일입니다.

REST는 'Representational State Transfer'의 줄임말로, Google API의 맥락에서 REST는 HTTP 동사를 사용하여 Google이 저장한 데이터 표현을 검색 및 수정하는 방법을 의미합니다.

RESTful 시스템에서는 리소스가 데이터 저장소에 저장되고, 클라이언트는 서버에서 특정 작업(리소스 생성, 검색, 업데이트, 삭제 등)을 수행하라는 요청을 전송하며, 서버는 작업을 수행하고 응답을 전송합니다. 이 응답은 지정된 리소스 표현의 형식을 취하는 경우가 많습니다.

Google의 RESTful API에서는 클라이언트가 POST, GET, PUT, DELETE 등의 HTTP 동사를 사용하여 작업을 지정합니다. 다음과 같은 형식의 전역적으로 고유한 URI로 리소스를 지정합니다.

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

모든 API 리소스에는 HTTP에서 액세스할 수 있는 고유 URI가 있으므로 REST는 데이터 캐싱을 지원하며 웹의 분산형 인프라와의 연동성이 뛰어납니다.

HTTP 1.1 표준 문서의 메서드 정의를 확인하면 유용합니다. 문서에 GET, POST, PUT, DELETE의 사양이 포함되어 있습니다.

Android Over The Air API의 REST

Android Over The Air API 작업은 REST HTTP 동사에 직접 매핑됩니다.

Android Over The Air API URI의 구체적인 형식은 다음과 같습니다.

https://www.googleapis.com/android/over-the-air/v1/resourcePath?parameters

API에서 지원되는 각 작업에 사용되는 전체 URI 집합은 Android Over The Air API 참조 문서에 요약되어 있습니다.

JSON 기본사항 알아보기

Android Over The Air API는 JSON 형식으로 데이터를 반환합니다.

JSON(JavaScript Object Notation)은 특정 언어에 의존하지 않는 일반적인 데이터 형식으로, 임의의 데이터 구조를 간단한 텍스트로 표현할 수 있습니다. 자세한 내용은 json.org를 참조하세요.