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
의 사양이 포함되어 있습니다.
Compute Engine API의 REST
Compute Engine API 작업은 REST HTTP 동사에 직접 매핑됩니다.
Compute Engine API URI의 특정 형식은 다음과 같습니다.
https://www.googleapis.com/compute/v1/resourcePath?parameters
API에서 지원되는 각 작업에 사용되는 전체 URI 집합은 Compute Engine API 참조 문서에 요약되어 있습니다.