용어

네트워크 API

  • 컴퓨터 네트워크에서 실행되는 애플리케이션 프로그래밍 인터페이스입니다. 이 API는 HTTP 및 gRPC를 포함한 네트워크 프로토콜을 사용해 통신하며, API를 사용하는 조직이 아닌 다른 조직에서도 빈번하게 작성됩니다.

Google API

  • Google 서비스에서 제공하는 네트워크 API를 말하며, 대부분은 googleapis.com 도메인에서 호스팅됩니다. 이 용어에는 클라이언트 라이브러리 및 SDK와 같은 다른 유형의 API는 포함되지 않습니다.

    모든 Google API는 공통 사용 모델을 공유합니다. API 사용자는 API 제작자가 관리하는 API 서비스를 사용합니다. 이를 통해 사용자는 Google API에서 간단하고 일관된 환경을 사용할 수 있습니다.

Google Cloud API

  • Google Cloud 서비스에 의해 노출되는 Google API의 하위 집합입니다. 자세한 정보는 Cloud APIs를 참조하세요.

API 인터페이스

  • 프로토콜 버퍼 service 정의입니다. 일반적으로 대부분 프로그래밍 언어의 인터페이스로 매핑됩니다. API 인터페이스는 다수의 API 서비스에서 구현될 수 있습니다.

API 버전

  • API 인터페이스 또는 API 인터페이스 그룹(함께 정의된 경우)의 버전입니다. API 버전은 종종 'v1' 같은 문자열로 표현되며, API 요청과 프로토콜 버퍼 패키지 이름에도 나타납니다.

API 메소드

  • API 인터페이스에서 실행되는 개별 작업을 말합니다. 프로토콜 버퍼에서 rpc 정의를 통해 표현되며, 일반적으로 대부분 프로그래밍 언어의 인터페이스 내의 기능으로 매핑됩니다.

API 요청

  • API 메소드에 대한 단일 호출을 말합니다. 결제, 로깅, 모니터링 및 비율 한도를 나타내는 단위로 사용되기도 합니다.

API 서비스

  • API 인터페이스 1개 이상이 배포된 구현체로서 네트워크 주소 하나 이상(예: Cloud Pub/Sub API)에 공개됩니다.

    Google API의 경우 API서비스의 개념이 API 서비스의 동의어로 사용됩니다. 이 목록은 Google Cloud Console의 API 라이브러리에 나열됩니다.

API 서비스 이름

  • API 서비스의 논리적 식별자를 나타냅니다. Google API는 RFC 1035 DNS 호환 이름을 'pubsub.googleapis.com'과 같은 API 서비스 이름으로 사용합니다.

API 서비스 엔드포인트

  • API 서비스가 실제 API 요청을 처리하기 위해 사용하는 네트워크 주소를 나타냅니다. 하나의 API 서비스에는 https://pubsub.googleapis.comhttps://content-pubsub.googleapis.com과 같은 여러 API 서비스 엔드포인트를 포함할 수 있습니다.

API 서비스 정의

  • API 서비스를 정의할 때 사용되는 API 인터페이스 정의(.proto 파일)와 API 서비스 구성(.yaml 파일)의 조합입니다. Google API 서비스 정의의 스키마는 google.api.Service입니다.

API 제품

  • API 서비스 외에도 서비스 약관, 설명서, 클라이언트 라이브러리, 서비스 지원 등이 모두 하나의 제품으로 고객에게 제공됩니다. 예를 들면 Google Calendar API입니다. 간혹 API 제품을 단순히 API라고 부릅니다.

API 사용자

  • API 서비스를 사용하는 개체입니다. Google API의 경우에는 일반적으로 클라이언트 애플리케이션 또는 서버 리소스를 소유하는 Google 프로젝트가 여기에 해당합니다.

API 작성자

  • API 서비스를 작성하는 개체입니다. Google API의 경우에는 일반적으로 API 서비스를 소유하는 Google 프로젝트가 여기에 해당합니다.

API 백엔드

  • 서버를 비롯해 API 서비스에 비즈니스 로직을 구현하는 관련 인프라를 말합니다. 각 API 백엔드 서버는 종종 API 서버라고 불리기도 합니다.

API 프런트엔드

  • 서버를 비롯해 부하 분산, 인증 같은 공통 기능을 API 서비스에게 제공하는 관련 인프라를 말합니다. 각 API 프런트엔드 서버는 종종 API 프록시라고 불리기도 합니다.

    API 프런트엔드와 API 백엔드가 나란히 또는 서로 멀리서 실행될 수 있습니다. 경우에 따라 두 가지 모두 단일 애플리케이션 바이너리로 컴파일되어 단일 프로세스에서 실행될 수도 있습니다.