용어

Network API

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

Google API

  • Google 서비스에서 제공하는 Network API입니다. 대부분은 googleapis.com 도메인에서 호스팅됩니다. Google Cloud Console, Service Usage API를 사용하여 사용 가능한 Google API를 확인할 수 있습니다. 이 용어에는 클라이언트 라이브러리 및 SDK와 같은 다른 유형의 API는 포함되지 않습니다.

Google Cloud API

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

API 인터페이스

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

API 버전

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

API 메소드

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

API 요청

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

API 서비스

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

API 제목

  • 'Cloud Pub/Sub API'와 같은 API 서비스의 사용자용 제품 제목을 나타냅니다.

API 서비스 이름

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

API 서비스 엔드포인트

  • API 서비스가 실제 API 요청을 처리하기 위해 사용하는 네트워크 주소를 나타냅니다. 예를 들면 https://pubsub.googleapis.com, https://content-pubsub.googleapis.com입니다. 단일 서비스에 엔드포인트가 두 개 이상 있을 수 있습니다.

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 백엔드가 나란히 또는 서로 멀리서 실행될 수 있습니다. 경우에 따라 두 가지 모두 단일 애플리케이션 바이너리로 컴파일되어 단일 프로세스에서 실행될 수도 있습니다.