Google Cloud API
Google Cloud API는 Google Cloud Platform 서비스의 프로그래매틱 인터페이스입니다.
Google Cloud Platform의 핵심으로, 컴퓨팅에서 네트워킹, 스토리지, 머신러닝 기반 데이터 분석까지 모든 기능을 애플리케이션에 손쉽게 추가할 수 있습니다.
Cloud API 정보
Cloud API는 고객에게 Cloud Pub/Sub API와 같은 네트워크 API 서비스로 노출됩니다. 각 Cloud API는 일반적으로 하나 이상의 googleapis.com 하위 도메인(예: pubsub.googleapis.com)에서 실행되며 공개 인터넷 및 virtual private cloud(VPC) 네트워크를 통해 클라이언트에 JSON HTTP 및 gRPC 인터페이스를 모두 제공합니다. 클라이언트는 HTTP와 gRPC 요청을 Cloud API 엔드포인트로 직접 보내거나 클라이언트 라이브러리를 사용하여 전송할 수 있습니다.
Cloud API는 Google Cloud 콘솔 API 라이브러리의 Google Enterprise API 카테고리에 속합니다.
Cloud API 액세스
Cloud API는 인기 있는 여러 프로그래밍 언어로 Google의 클라이언트 라이브러리를 사용해 서버 애플리케이션에서, Firebase SDK를 통해 모바일 앱에서, 혹은 제3자 클라이언트를 사용해 액세스할 수 있습니다. Google Cloud CLI 도구 또는 Google Cloud 콘솔을 사용하여 Cloud API에 액세스할 수도 있습니다.
Cloud API를 처음 사용하는 경우 Cloud API 사용 방법에 대한 시작하기를 참조하세요.
HTTP 및 gRPC 지원
모든 Cloud API는 직접 또는 Google API 클라이언트 라이브러리를 통해 호출할 수 있는 간단한 JSON HTTP 인터페이스를 제공합니다.
또한 대부분의 Cloud API는 더 나은 성능과 사용성을 제공하는 Google Cloud 클라이언트 라이브러리를 통해 호출할 수 있는 gRPC 인터페이스를 제공합니다. 타사 클라이언트를 사용할 수도 있습니다.
클라이언트 라이브러리에 대한 자세한 내용은 클라이언트 라이브러리 설명을 참조하세요.
TLS 암호화
모든 Cloud API는 TLS 암호화를 사용하는 보안 요청만 수락합니다.
- 클라이언트 라이브러리 중 하나를 사용 중인 경우 전송 중인 데이터 암호화가 라이브러리에서 자동으로 처리됩니다.
- 자체 gRPC 클라이언트를 사용하는 경우 gRPC 인증 가이드의 안내에 따라 Google에 인증해야 합니다(TLS 필요).
- 자체 HTTP 클라이언트를 만들려면 HTTP 가이드라인을 참조하세요.
전송 중인 데이터 암호화 보안 가이드에서 Google Cloud 서비스로 들어오는 트래픽을 보호하는 방법에 대해 자세히 알아볼 수 있습니다.
Private Service Connect
기업 고객은 보안 및 규정 준수를 위해 Cloud API에 비공개로 액세스하는 경우가 많습니다. Private Service Connect을 사용하여 VPC 네트워크 내에서 이러한 액세스를 설정하고 관리할 수 있습니다.
자세한 내용은 Private Service Connect 구성을 참조하세요.
단계별 예시
인기 API에 클라이언트 라이브러리를 사용하기 위한 다음 단계별 안내를 참조하세요.
API 설계 가이드
인터페이스 유형에 상관없이 모든 Cloud API는 API 디자인 가이드에 설명된 대로 리소스 중심 디자인 원칙을 사용합니다. 이는 Cloud API가 단순하고 일관된 개발자 환경을 가지도록 합니다.
Cloud API를 보다 잘 이해하려면 API 디자인 가이드를 참조하세요.
Cloud API의 인터페이스 정의를 학습하려면 GitHub의 Google API 저장소를 방문하세요.
사용량 상한 설정
Cloud API는 수백만 명의 개발자와 사용자 간에 공유됩니다. 공정한 사용을 보장하고 악용 위험을 최소화하기 위해 모든 Cloud API는 일반적으로 할당량이라고 하는 비율 제한 및 리소스 할당량을 적용합니다. 또한 이러한 할당량을 사용하여 할당량 한도를 줄이면 Google Cloud 제품의 지출을 관리할 수 있습니다. 기본 한도보다 더 많은 할당량이 필요하다면 할당량 상향 요청을 제출해야 합니다.
자세한 내용은 API 사용량 상한 설정을 참조하세요.
사용량 모니터링
대부분 Cloud API가 트래픽 수준, 오류율, 지연 시간 등 프로젝트의 API 사용량에 관한 정보를 자세하게 제공하기 때문에 Cloud API를 사용하는 애플리케이션의 문제를 빠르게 분류할 수 있습니다. 이 정보는 Google Cloud Console의 Google Cloud API 대시보드에서 확인할 수 있습니다. Cloud Monitoring에서 커스텀 대시보드와 알림을 만들 수도 있습니다.
자세한 내용은 Monitoring API 사용량을 참조하세요.
Google Enterprise API
Google Enterprise API는 안정성이 뛰어난 API로, 사용 가능한 지원 옵션과 함께 엔터프라이즈에 바로 사용할 수 있습니다.
자세한 내용은 Google Enterprise API를 참조하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-12-21(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-12-21(UTC)"],[[["\u003cp\u003eGoogle Cloud APIs are programmatic interfaces that allow developers to integrate Google Cloud services, such as computing, networking, and machine learning, into their applications.\u003c/p\u003e\n"],["\u003cp\u003eCloud APIs can be accessed through various methods, including client libraries, Firebase SDKs, third-party clients, the Google Cloud CLI, and the Google Cloud console.\u003c/p\u003e\n"],["\u003cp\u003eThese APIs support both JSON HTTP and gRPC interfaces, with gRPC offering enhanced performance and usability through Google Cloud Client Libraries.\u003c/p\u003e\n"],["\u003cp\u003eCloud APIs are categorized into resource-based and client-based, which determine the project used for billing and quota purposes.\u003c/p\u003e\n"],["\u003cp\u003eAll Cloud APIs enforce rate limits and quotas to ensure fair usage and to help users manage their spending on Google Cloud products.\u003c/p\u003e\n"]]],[],null,["# Google Cloud APIs are programmatic interfaces to Google Cloud Platform services.\nThey are a key part of Google Cloud Platform, allowing you to easily add the\npower of everything from computing to networking to storage to\nmachine-learning-based data analysis to your applications.\n\nAbout Cloud APIs\n----------------\n\nCloud APIs are exposed as network API services to customers, such as\n[Cloud Pub/Sub API](/pubsub). Each Cloud API typically runs on one or more\nsubdomains of `googleapis.com`, such as `pubsub.googleapis.com`, and provides\nboth JSON HTTP and gRPC interfaces to clients over public internet and\nVirtual Private Cloud (VPC) networks. Clients can send HTTP and gRPC\nrequests to Cloud API endpoints directly or by using client libraries.\n\nCloud APIs are part of the [Google Enterprise\nAPIs](/apis/docs/resources/enterprise-apis) category in the Google Cloud console\n[API Library](https://console.cloud.google.com/apis/library/browse?filter=category:enterprise-api).\n\nThere are two kinds of Google Cloud APIs:\n\n- *Resource-based APIs*, which use the project associated with the resources\n being accessed for billing and quota.\n\n- *Client-based APIs*, which use the project associated with the client\n accessing the resources for billing and quota.\n\nAccessing Cloud APIs\n--------------------\n\nYou can access Cloud APIs from server applications with our\n[client libraries](/apis/docs/client-libraries-explained)\nin many popular programming languages, from mobile apps via the\n[Firebase SDKs](https://firebase.google.com/docs),\nor by using third-party clients. You can also access Cloud APIs with the\n[Google Cloud CLI](/sdk) or\n[Google Cloud console](https://console.cloud.google.com/).\n\nIf you are new to Cloud APIs, see [Getting Started](/apis/docs/getting-started)\non how to use Cloud APIs.\n\n### Supporting HTTP and gRPC\n\nAll Cloud APIs provide a simple JSON HTTP interface that you can call directly\nor via\n[Google API Client Libraries](https://developers.google.com/api-client-library).\nMost Cloud APIs also provide a\n[gRPC](https://grpc.io)\ninterface you can call via\n[Google Cloud Client Libraries](/apis/docs/cloud-client-libraries),\nwhich provide better performance and usability. You can also use third-party\nclients.\n\nFor more information about our client libraries, see\n[Client Libraries Explained](/apis/docs/client-libraries-explained).\n\nFor more information about authentication for using Google APIs, see\n[Authentication methods at Google](/docs/authentication) and\n[Authentication for using client libraries](/docs/authentication/client-libraries).\n\n### TLS encryption\n\nAll Cloud APIs accept only secure requests using TLS encryption.\n\n- If you are using one of our client libraries, in-transit encryption is handled for you by the library.\n- If you are using your own gRPC client, you need to authenticate with Google (which requires TLS) following the instructions in the [gRPC authentication guide](https://grpc.io/docs/guides/auth/).\n- If you are creating your own HTTP client, see our [HTTP guidelines](/apis/docs/http).\n\nYou can find out more about how traffic to Google Cloud services is secured in\nour [Encryption in Transit](/security/encryption-in-transit) security guide.\n\n### Private Service Connect\n\nEnterprise customers often want to access Cloud APIs privately for security\nand compliance reasons. You can use Private Service Connect to\nset up and manage such access within your VPC networks.\n\nFor more information, see\n[Configuring Private Service Connect](/vpc/docs/configure-private-service-connect-apis).\n\n### Step-by-step examples\n\nSee the following step-by-step guides that use the client libraries for some\npopular APIs:\n\n- [Cloud Billing Budget API with Node.js](https://console.cloud.google.com/?tutorial=billing--budget--billing-budget-api-nodejs).\n- [Cloud Billing Budget API with Python](https://console.cloud.google.com/?tutorial=billing--budget--billing-budget-api-python).\n- [Cloud Logging with Node.js](https://console.cloud.google.com/?tutorial=logging--logging-nodejs).\n- [Cloud Logging with Python](https://console.cloud.google.com/?tutorial=logging--logging-python).\n- [Cloud Logging with Go](https://console.cloud.google.com/?tutorial=logging--logging-go).\n- [Cloud Logging with Java](https://console.cloud.google.com/?tutorial=logging--logging-java).\n- [Speech-to-Text with Node.js](https://console.cloud.google.com/?tutorial=speech-to-text--speech-to-text-nodejs).\n- [Speech-to-Text with Python](https://console.cloud.google.com/?tutorial=speech-to-text--speech-to-text-python).\n- [Speech-to-Text with Go](https://console.cloud.google.com/?tutorial=speech-to-text--speech-to-text-go).\n- [Speech-to-Text with Java](https://console.cloud.google.com/?tutorial=speech-to-text__speech-to-text-java).\n\nAPI Design Guide\n----------------\n\nRegardless of the interface type, all Cloud APIs use resource-oriented design\nprinciples as described in our [API Design Guide](/apis/design), which\nensures Cloud APIs to have a simple and consistent developer experience.\nYou can reference our API Design Guide to have a better understanding of Cloud\nAPIs.\n\nIf you want to study the interface definition of Cloud APIs, you can visit the\n[Google APIs](https://github.com/googleapis/googleapis) repository on GitHub.\n\nCapping your usage\n------------------\n\nCloud APIs are shared among millions of developers and users. To ensure fair\nusage and minimize abuse risks, all Cloud APIs are enforcing rate limits and\nresource quotas on usage, commonly known as quotas. You can also use these\nquotas to control your spending on Google Cloud products by reducing your own\nquota limits. If you need more quotas than the default limits, you need\nto file quota increase requests.\n\nFor more information, see [Capping API usage](/apis/docs/capping-api-usage).\n\nMonitoring your usage\n---------------------\n\nMost Cloud APIs provide you with detailed information on your project's usage\nof that API, including traffic levels, error rates, and latencies. It helps\nyou to quickly triage problems with applications that use Cloud APIs. You can\nview this information in the Google Cloud\n[API Dashboard](https://console.cloud.google.com/apis/dashboard) in the Google Cloud console. You\ncan also create custom dashboards and alerts in Cloud Monitoring.\n\nFor more information, see [Monitoring API usage](/apis/docs/monitoring).\n\nGoogle Enterprise APIs\n----------------------\n\nGoogle Enterprise APIs are high-stability APIs, ready for enterprise use with\nsupport options available.\n\nFor more information, see\n[Google Enterprise APIs](/apis/docs/resources/enterprise-apis).\n\nTry it for yourself\n-------------------\n\n\nIf you're new to Google Cloud, create an account to evaluate how our\nproducts perform in real-world scenarios. New customers also get $300 in\nfree credits to run, test, and deploy workloads.\n[Get started for free](https://console.cloud.google.com/freetrial)"]]
