홈페이지>프로그래밍 관련>자바 소스 코드
다운로드

Google Cloud 자바 클라이언트 라이브러리

Google Cloud Platform 서비스를 위한 자바 관용적 클라이언트입니다.

  • Google Cloud의 자바

지원되는 API

개별 Google Cloud 서비스와 상호작용하는 자바 애플리케이션을 개발하기 위해 GitHub 및 Maven Central에서 라이브러리를 사용할 수 있습니다.

고객 릴리스 수준 버전
AI Platform 노트북
API 게이트웨이
API 키 API
접근 승인
자문 알림 API
합금DB
AlloyDB 커넥터
분석 허브 API
Apigee Connect
App Engine 관리 API
유물 등록소
자산 재고
정부를 위한 보장된 워크로드
자동 ML
백업 및 DR 서비스 API
BigQuery
BigQuery 연결
BigQuery 데이터 전송 서비스
BigQuery 예약
BigQuery 스토리지
빅테이블
Bigtable Hbase 클라이언트
청구
청구 예산
바이너리 승인
짓다
CCAI 인사이트
인증 기관 서비스
채널 서비스
작곡가
컴퓨팅 엔진
게이트웨이 API 연결
컨테이너 분석
파트너 API 제어
DNS
데이터 카탈로그
데이터 융합
데이터 계보
데이터 손실 방지
데이터베이스 마이그레이션 서비스
데이터플렉스
Dataproc
Dataproc 메타스토어
데이터스토어
데이터스트림
디버거
배포
다이얼로그플로우 API
디스커버리 엔진 API
분산 에지
분산 에지 네트워크 API
문서 AI
도메인
필수 연락처 API
이벤트타르크
파일 저장소 API
소방서
함대 경로
기능
GKE 허브 API
그래요
IAM 관리 API
IAM 정책 문제 해결사 API
IAM 서비스 계정 자격 증명 API
ID 액세스 컨텍스트 관리자
신원 인식 프록시 API
인프라 관리자 API
사물인터넷(IoT) 코어
침입탐지시스템
키 관리 서비스
쿠버네티스 엔진
벌채 반출
Microsoft Active Directory를 위한 관리형 서비스
멤캐시
모니터링 대시보드
자연어
네트워크 연결 센터
네트워크 관리 API
네트워크 보안 API
OS 구성 API
OS 로그인
조직 정책
프로파일러
게시/구독
Pub/Sub 그룹 Kafka 커넥터
게시/구독 라이트
Pub/Sub Lite 카프카 심
Pub/Sub Lite Spark 커넥터
공용 인증 기관 API
할당량 API
추천자
레디스
리소스 관리자 API
리소스 설정 API
소매
경로 API
스케줄러
비밀 관리
보안 소스 관리자 API
보안센터 관리 API
보안 지휘 센터
보안 상태 API
보안 스캐너
서버리스 VPC 액세스
서비스 제어 API
서비스 디렉토리
서비스 관리 API
서비스 이용
껍데기
스패너
스패너 JDBC
연설
Stackdriver 모니터링
스택드라이버 추적
저장
보관이전 서비스
TPU
인재솔루션
작업
통신 자동화 API
텍스트 음성 변환
번역
VM 마이그레이션
버텍스 AI
VertexAI API
비디오 인텔리전스
비디오 합치기 API
비디오 트랜스코더
비전
웹 위험
워크플로 실행
워크플로
Workspace 애드온 API
워크스테이션
reCAPTCHA 엔터프라이즈
API 허브 API
애드 관리자 API
주소 확인 API
분석 관리자
분석 데이터
분석 허브
Anthos 멀티클라우드
Apache Kafka API용 관리형 서비스
앱 허브 API
면적 120 테이블
GKE용 백업
베어메탈 솔루션
일괄
BeyondCorp AppConnections
BeyondCorp AppConnectors
BeyondCorp 앱게이트웨이
BeyondCorp ClientConnectorServices
BeyondCorp 클라이언트게이트웨이
빅레이크
BigQuery 데이터 정책 API
BigQuery 마이그레이션
CSS API
인증서 관리자
채팅 API
상업 소비자 조달
기밀 컴퓨팅 API
게이트웨이 API 연결
데이터 라벨링
데이터 흐름
데이터 양식
개발자 연결 API
다이얼로그플로우 CX
문서 AI 창고
기업 지식 그래프
오류 보고
이벤트타르크 출판
GDC 하드웨어 관리 API
KMS 인벤토리 API
생명 과학
라이브 스트림 API
로깅 로그백 어펜더
로깅 서블릿 초기화 프로그램
지도 플랫폼 데이터세트 API
마케팅 플랫폼 관리 API
미디어 번역 API
API를 만나보세요
Redis API용 Memorystore
판매자 API
판매자 API
판매자 API
판매자 API
판매자 API
판매자 API
판매자 전환 API
판매자 LFP API
판매자 알림 API
판매자 할당량 API
마이그레이션 센터 API
측정항목 범위 모니터링
스토리지용 NIO 파일 시스템 공급자
넷앱 API
네트워크 서비스 API
오라클 데이터베이스@API
병렬 저장소 API
피싱 방지
장소 API(신규)
장소 통찰력 API
정책 시뮬레이터 API
비공개 카탈로그
권한 있는 액세스 관리자 API
Pub/Sub Lite Flink 커넥터
신속한 마이그레이션 평가 API
추천 AI
레지스트리 API
경로 최적화 API
달리다
Security Command Center 설정 API
서비스 상태 API
태양광 API
스토리지 인사이트 API
지원 API
VMware 엔진
비전 AI API
작업공간 이벤트 API

서비스가 목록에 없으면 google-api-java-client는 기존 REST 인터페이스를 사용하여 추가 Google Cloud API와 인터페이스합니다.

Java 애플리케이션을 구축할 때 표에 나열된 라이브러리가 우선적으로 제공되어야 합니다.

프로젝트 ID 지정

대부분의 google-cloud 라이브러리에는 프로젝트 ID가 필요합니다. 이 프로젝트 ID를 지정하는 방법에는 여러 가지가 있습니다.

  1. Compute/App Engine 내에서 google-cloud 라이브러리를 사용하는 경우 프로젝트 ID를 지정할 필요가 없습니다. 프로덕션 환경에서 자동으로 추론됩니다.
  2. 다른 곳에서 google-cloud 사용하는 경우 다음 중 하나를 수행할 수 있습니다.

  • 서비스 옵션을 빌드할 때 프로젝트 ID를 제공하세요. 예를 들어 ID가 'PROJECT_ID'인 프로젝트의 Datastore를 사용하려면 다음과 같이 작성하면 됩니다. 

     Datastore datastore = DatastoreOptions . newBuilder (). setProjectId ( "PROJECT_ID" ). build (). getService ();

  • 환경 변수 GOOGLE_CLOUD_PROJECT 원하는 프로젝트 ID로 지정하세요.

  • Google Cloud SDK를 사용하여 프로젝트 ID를 설정합니다. SDK를 사용하려면 아직 SDK를 다운로드하지 않은 경우 다운로드하고 명령줄에서 프로젝트 ID를 설정하세요. 예를 들어: 

     gcloud config set project PROJECT_ID

google-cloud 다음 소스에서 나열된 순서대로 프로젝트 ID를 확인하고 값을 찾으면 중지합니다.

  1. 서비스 옵션 빌드 시 제공되는 프로젝트 ID
  2. 환경 변수 GOOGLE_CLOUD_PROJECT 로 지정된 프로젝트 ID
  3. App Engine/Compute Engine 프로젝트 ID
  4. GOOGLE_APPLICATION_CREDENTIALS 환경 변수가 가리키는 JSON 자격 증명 파일에 지정된 프로젝트 ID
  5. Google Cloud SDK 프로젝트 ID

라이브러리가 프로젝트 ID를 명시적으로 예상하는 경우 추론된 프로젝트 ID를 제공할 수 있는 도우미를 제공합니다. 

  import com . google . cloud . ServiceOptions ;
  ...
  String projectId = ServiceOptions . getDefaultProjectId ();

입증

google-cloud-java https://github.com/googleapis/google-auth-library-java를 사용하여 요청을 인증합니다. google-auth-library-java 다양한 인증 유형을 지원합니다. 자세한 내용은 프로젝트의 README 및 javadoc를 참조하세요.

구글 클라우드 플랫폼 환경

Compute Engine, Kubernetes Engine, App Engine과 같은 Google Cloud Platform 환경에서 Google Cloud 라이브러리를 사용하는 경우 추가 인증 단계가 필요하지 않습니다.

예를 들어: 

 Storage storage = StorageOptions . getDefaultInstance (). getService ();

또는: 

 CloudTasksClient cloudTasksClient = CloudTasksClient . create ();

기타 환경

서비스 계정 사용(권장)

  1. JSON 서비스 계정 키를 생성합니다.

  2. 해당 키를 다운로드한 후 다음 중 하나를 수행해야 합니다.

    • 환경 변수 GOOGLE_APPLICATION_CREDENTIALS를 키 위치로 정의합니다. 예를 들어: 
     export GOOGLE_APPLICATION_CREDENTIALS=/path/to/my/key.json
    • 서비스 옵션을 구축할 때 JSON 자격 증명 파일을 제공하세요. 예를 들어 이 Storage 개체에는 Google Cloud Storage 데이터와 상호작용하는 데 필요한 권한이 있습니다. 
     Storage storage = StorageOptions . newBuilder ()
    . setCredentials ( ServiceAccountCredentials . fromStream ( new FileInputStream ( "/path/to/my/key.json" )))
    . build ()
    . getService ();

로컬 개발/테스트

개발/테스트를 위해 로컬에서 실행하는 경우 Google Cloud SDK를 사용할 수 있습니다. gcloud auth application-default login 사용하여 애플리케이션 기본 사용자 인증 정보를 생성하면 google-cloud 해당 사용자 인증 정보를 자동으로 감지합니다.

기존 OAuth2 액세스 토큰

OAuth2 액세스 토큰이 이미 있는 경우 이를 사용하여 인증할 수 있습니다(이 경우 액세스 토큰은 자동으로 새로 고쳐지지 않습니다). 

 Credentials credentials = GoogleCredentials . create ( new AccessToken ( accessToken , expirationTime ));
Storage storage = StorageOptions . newBuilder ()
    . setCredentials ( credentials )
    . build ()
    . getService ();

또는: 

 Credentials credentials = GoogleCredentials . create ( new AccessToken ( accessToken , expirationTime ));
CloudTasksSettings cloudTasksSettings = CloudTasksSettings . newBuilder ()
    . setCredentialProvider ( FixedCredentialsProvider . create ( credentials ))
    . build ();
CloudTasksClient cloudTasksClient = CloudTasksClient . create ( cloudTasksSettings );

애플리케이션 기본 자격 증명

사용자 인증 정보가 제공되지 않으면 google-cloud 다음 위치에서 순서대로 애플리케이션 기본 사용자 인증 정보를 검색하는 GoogleCredentials.getApplicationDefault() 사용하여 환경에서 사용자 인증 정보를 감지하려고 시도합니다.

  1. GOOGLE_APPLICATION_CREDENTIALS 환경 변수가 가리키는 자격 증명 파일
  2. Google Cloud SDK gcloud auth application-default login 명령어에서 제공하는 사용자 인증 정보
  3. Google App Engine 내장 자격 증명
  4. Google Cloud Shell 내장 사용자 인증 정보
  5. Google Compute Engine 내장 자격 증명

API 키로 인증

API 키를 사용한 인증은 소수의 Google Cloud API에서 지원됩니다.

우리는 API 키 환경을 개선하는 방법을 적극적으로 모색하고 있습니다. 현재 Java 클라이언트 라이브러리에서 API Key를 사용하려면 해당 서비스 클라이언트에 대한 헤더를 수동으로 설정해야 합니다.

예를 들어 언어 서비스로 API 키를 설정하려면 다음을 수행하세요. 

 public LanguageServiceClient createGrpcClientWithApiKey ( String apiKey ) throws Exception {
    // Manually set the api key via the header
    Map < String , String > header = new HashMap < String , String >() { { put ( "x-goog-api-key" , apiKey );}};
    FixedHeaderProvider headerProvider = FixedHeaderProvider . create ( header );

    // Create the client
    TransportChannelProvider transportChannelProvider = InstantiatingGrpcChannelProvider . newBuilder (). setHeaderProvider ( headerProvider ). build ();
    LanguageServiceSettings settings = LanguageServiceSettings . newBuilder (). setTransportChannelProvider ( transportChannelProvider ). build ();
    LanguageServiceClient client = LanguageServiceClient . create ( settings );
    return client ;
  }

나머지를 사용하는 언어 클라이언트의 인스턴스화 예: 

 public LanguageServiceClient createRestClientWithApiKey ( String apiKey ) throws Exception {
    // Manually set the api key header
    Map < String , String > header = new HashMap < String , String >() { { put ( "x-goog-api-key" , apiKey );}};
    FixedHeaderProvider headerProvider = FixedHeaderProvider . create ( header );

    // Create the client
    TransportChannelProvider transportChannelProvider = InstantiatingHttpJsonChannelProvider . newBuilder (). setHeaderProvider ( headerProvider ). build ();
    LanguageServiceSettings settings = LanguageServiceSettings . newBuilder (). setTransportChannelProvider ( transportChannelProvider ). build ();
    LanguageServiceClient client = LanguageServiceClient . create ( settings );
    return client ;
  }

문제 해결

도움을 받으려면 문제 해결 문서의 지침을 따르십시오.

프록시 구성

Google Cloud 클라이언트 라이브러리는 서비스와의 기본 통신에 HTTPS 및 gRPC를 사용합니다. 두 프로토콜 모두에서 https.proxyHost 및 (선택 사항) https.proxyPort 속성을 사용하여 프록시를 구성할 수 있습니다.

gRPC 사용자 정의 프록시 구성

gRPC를 사용하는 추가 사용자 지정 프록시의 경우 ManagedChannelBuilder 에 ProxyDetector 제공해야 합니다. 

 import com . google . api . core . ApiFunction ;
import com . google . api . gax . rpc . TransportChannelProvider ;
import com . google . cloud . tasks . v2 . CloudTasksClient ;
import com . google . cloud . tasks . v2 . CloudTasksSettings ;
import com . google . cloud . tasks . v2 . stub . CloudTasksStubSettings ;
import io . grpc . HttpConnectProxiedSocketAddress ;
import io . grpc . ManagedChannelBuilder ;
import io . grpc . ProxiedSocketAddress ;
import io . grpc . ProxyDetector ;

import javax . annotation . Nullable ;
import java . io . IOException ;
import java . net . InetSocketAddress ;
import java . net . SocketAddress ;

public CloudTasksClient getService () throws IOException {
  TransportChannelProvider transportChannelProvider =
      CloudTasksStubSettings . defaultGrpcTransportProviderBuilder ()
          . setChannelConfigurator (
              new ApiFunction < ManagedChannelBuilder , ManagedChannelBuilder >() {
                @ Override
                public ManagedChannelBuilder apply ( ManagedChannelBuilder managedChannelBuilder ) {
                  return managedChannelBuilder . proxyDetector (
                      new ProxyDetector () {
                        @ Nullable
                        @ Override
                        public ProxiedSocketAddress proxyFor ( SocketAddress socketAddress )
                            throws IOException {
                          return HttpConnectProxiedSocketAddress . newBuilder ()
                              . setUsername ( PROXY_USERNAME )
                              . setPassword ( PROXY_PASSWORD )
                              . setProxyAddress ( new InetSocketAddress ( PROXY_HOST , PROXY_PORT ))
                              . setTargetAddress (( InetSocketAddress ) socketAddress )
                              . build ();
                        }
                      });
                }
              })
          . build ();
  CloudTasksSettings cloudTasksSettings =
      CloudTasksSettings . newBuilder ()
          . setTransportChannelProvider ( transportChannelProvider )
          . build ();
  return CloudTasksClient . create ( cloudTasksSettings );
}

장기 실행 작업

장기 실행 작업(LRO)은 완료하는 데 오랜 시간이 걸릴 것으로 예상되는 API 호출(예: GCE 인스턴스 또는 Dataflow 파이프라인 프로비저닝)에 사용되는 경우가 많습니다. 초기 API 호출은 서버에 "작업"을 생성하고 작업 ID를 반환하여 진행 상황을 추적합니다. LRO RPC에는 호출 이름에 접미사 Async 추가됩니다(예: clusterControllerClient.createClusterAsync() ).

생성된 클라이언트는 작업을 시작한 다음 작업이 완료될 때까지 기다리는 데 유용한 인터페이스를 제공합니다. 이는 OperationFuture 반환하여 수행됩니다. OperationFuture 에서 get() 호출하면 클라이언트 라이브러리는 작업을 폴링하여 작업 상태를 확인합니다.

예를 들어 google-cloud-dataproc v4.20.0의 샘플 createCluster 작업을 살펴보겠습니다. 

 try ( ClusterControllerClient clusterControllerClient = ClusterControllerClient . create ()) {
  CreateClusterRequest request =
      CreateClusterRequest . newBuilder ()
          . setProjectId ( "{PROJECT_ID}" )
          . setRegion ( "{REGION}" )
          . setCluster ( Cluster . newBuilder (). build ())
          . setRequestId ( "{REQUEST_ID}" )
          . setActionOnFailedPrimaryWorkers ( FailureAction . forNumber ( 0 ))
          . build ();
  OperationFuture < Cluster , ClusterOperationMetadata > future =
      clusterControllerClient . createClusterOperationCallable (). futureCall ( request );
  // Do something.
  Cluster response = future . get ();
} catch ( CancellationException e ) {
  // Exceeded the default RPC timeout without the Operation completing.
  // Library is no longer polling for the Operation status. Consider 
  // increasing the timeout.
}

LRO 시간 초과

폴링 작업에는 서비스마다 다른 기본 제한 시간이 있습니다. 라이브러리는 다음 메시지와 함께 java.util.concurrent.CancellationException 을 발생시킵니다. Task was cancelled. 시간 초과가 작업을 초과하는 경우. CancellationException 은 백엔드 GCP 작업이 취소되었음을 의미하지 않습니다. 이 예외는 작업에서 성공 상태를 받지 못한 채 총 제한 시간을 초과한 경우 클라이언트 라이브러리에서 발생합니다. 클라이언트 라이브러리는 각 RPC에 대해 OperationTimedPollAlgorithm에 설정된 구성된 값을 따릅니다.

참고: 클라이언트 라이브러리는 작업의 폴링 메커니즘을 처리합니다. 기본적으로 상태를 수동으로 폴링할 필요는 없습니다.

기본 LRO 값

각 LRO RPC에는 미리 구성된 기본값 세트가 있습니다. 각 클라이언트의 StubSettings 클래스에서 검색하여 이러한 값을 찾을 수 있습니다. 기본 LRO 설정은 중첩된 Builder 클래스의 initDefaults() 메서드 내에서 초기화됩니다.

예를 들어 google-cloud-aiplatform v3.24.0에서 기본 OperationTimedPollAlgorithm의 기본값은 다음과 같습니다. 

 OperationTimedPollAlgorithm . create (
    RetrySettings . newBuilder ()
        . setInitialRetryDelay ( Duration . ofMillis ( 5000L ))
        . setRetryDelayMultiplier ( 1.5 )
        . setMaxRetryDelay ( Duration . ofMillis ( 45000L ))
        . setInitialRpcTimeout ( Duration . ZERO )
        . setRpcTimeoutMultiplier ( 1.0 )
        . setMaxRpcTimeout ( Duration . ZERO )
        . setTotalTimeout ( Duration . ofMillis ( 300000L ))
        . build ())

재시도와 LRO는 모두 동일한 RetrySettings 클래스를 공유합니다. 해당 링크를 참고하세요.

  • 총 시간 초과(폴링에 허용되는 최대 시간): 5분
  • 초기 재시도 지연(첫 번째 폴링 전 초기 지연): 5초
  • 최대 재시도 지연(각 폴링 간의 최대 지연): 45초
  • 재시도 지연 승수(폴링 지연을 늘리는 승수 값): 1.5

RPC 시간 초과 값은 LRO에서 사용되지 않으며 생략하거나 기본값(시간 초과의 경우 Duration.ZERO 또는 승수의 경우 1.0 )으로 설정할 수 있습니다.

LRO 시간 초과 구성

LRO 값을 구성하려면 OperationTimedPollAlgorithm 개체를 만들고 RPC의 폴링 알고리즘을 업데이트합니다. 예를 들어: 

 ClusterControllerSettings . Builder settingsBuilder = ClusterControllerSettings . newBuilder ();
TimedRetryAlgorithm timedRetryAlgorithm = OperationTimedPollAlgorithm . create (
		RetrySettings . newBuilder ()
				. setInitialRetryDelay ( Duration . ofMillis ( 500L ))
				. setRetryDelayMultiplier ( 1.5 )
				. setMaxRetryDelay ( Duration . ofMillis ( 5000L ))
				. setInitialRpcTimeout ( Duration . ZERO ) // ignored
				. setRpcTimeoutMultiplier ( 1.0 ) // ignored
				. setMaxRpcTimeout ( Duration . ZERO ) // ignored
				. setTotalTimeout ( Duration . ofHours ( 24L ))	// set polling timeout to 24 hours
				. build ());
settingsBuilder . createClusterOperationSettings ()
		. setPollingAlgorithm ( timedRetryAlgorithm );
ClusterControllerClient clusterControllerClient = ClusterControllerClient . create ( settingsBuilder . build ());

참고: 위 구성은 createClusterOperation RPC에 대한 LRO 값만 수정합니다. 클라이언트의 다른 RPC는 여전히 각 RPC의 사전 구성된 LRO 값을 사용합니다.

종속성 관리

두 개 이상의 Google Cloud 클라이언트 라이브러리를 사용하는 경우 BOM(Bill of Material) 아티팩트 중 하나를 사용하여 종속 항목 버전을 관리하는 것이 좋습니다. 자세한 내용은 클라우드 클라이언트 라이브러리 사용을 참조하세요.

자바 버전

이 저장소에서 클라이언트를 사용하려면 Java 8 이상이 필요합니다.

지원되는 플랫폼

이 저장소의 클라이언트는 전송 계층에 HTTP 또는 gRPC를 사용합니다. 모든 HTTP 기반 클라이언트는 모든 환경에서 작동해야 합니다.

gRPC를 사용하는 클라이언트의 경우 지원되는 플랫폼은 Forked Tomcat Native가 지원하는 플랫폼으로 제한됩니다. 이는 아키텍처의 경우 x86_64만 의미하고 운영 체제의 경우 Mac OS X, Windows 및 Linux를 의미합니다. 또한 gRPC는 스레딩 제한으로 플랫폼 사용을 제한합니다.

따라서 다음은 지원되지 않습니다.

  • 기계적 인조 인간
    • 이러한 API가 많이 포함되어 있는 Firebase를 고려해 보세요.
    • 지원되지는 않지만 많은 경우 이러한 라이브러리를 사용할 수 있습니다. 이 예제 저장소에서 이와 같은 예제를 찾을 수 있지만 애플리케이션에서 이러한 라이브러리를 사용하기 전에 위험을 주의 깊게 고려하십시오.
  • Raspberry Pi(ARM 아키텍처에서 실행되므로)
  • Google App Engine 표준 자바 7

다음 환경이 작동해야 합니다.

  • x86_64의 독립형 Windows
  • x86_64의 독립형 Mac OS X
  • x86_64의 독립형 Linux
  • 구글 컴퓨트 엔진(GCE)
  • Google 컨테이너 엔진(GKE)
  • Google App Engine 표준 Java 8(GAE Std J8)
  • Google App Engine Flex(GAE Flex)
  • 알파인 리눅스(Java 11+)

테스트

이 라이브러리는 google-cloud 서비스를 사용하는 코드에 대한 테스트를 작성하는 데 도움이 되는 도구를 제공합니다.

테스트 도우미 사용에 대한 자세한 내용은 테스트를 참조하세요.

버전 관리

이 라이브러리는 몇 가지 추가 조건과 함께 의미 체계 버전 관리를 따릅니다.

  1. @BetaApi 또는 @Experimental 로 표시된 구성 요소는 "1.x" 라이브러리 내의 "0.x" 기능으로 간주됩니다. 이는 호환되지 않는 방식으로 마이너 릴리스와 패치 릴리스 간에 변경될 수 있음을 의미합니다. @BetaApi 기능을 사용하는 라이브러리 B의 구성 요소도 @BetaApi 로 표시되지 않는 한 자체적으로 소비자가 있는 라이브러리 "B"에서는 이러한 기능을 사용해서는 안 됩니다. @BetaApi 로 표시된 기능은 마커가 제거되어 결국 "1.x" 기능이 되는 경로에 있습니다.

    google-cloud-java에 대한 특별 예외 : gax-java와 google-cloud-java가 서로 보조를 맞춰 움직이기 때문에 google-cloud-java는 소비 코드 @BetaApi 선언하지 않고 gax-java의 @BetaApi 기능에 의존할 수 있습니다. . 이러한 이유로 gax-java는 google-cloud-java와 독립적으로 사용되어서는 안 됩니다.

  2. @InternalApi 로 표시된 구성 요소는 기술적으로 공개되지만 Java 액세스 수정자의 제한으로 인해 발생합니다. semver의 목적상 비공개로 간주되어야 합니다.

  3. @InternalExtensionOnly 로 표시된 인터페이스는 공개이지만 내부 클래스에 의해서만 구현되어야 합니다. semver의 목적을 위해 우리는 기본 구현 없이 이러한 인터페이스를 추가할 수 있는 권리를 보유합니다(Java 7의 경우).

이 클라이언트는 현재 활발하게 개발 중입니다. 0.xy 버전의 모든 릴리스는 언제든지 이전 버전과 호환되지 않는 변경 사항이 있을 수 있습니다.

안정적인

안정적인 품질 수준으로 정의된 라이브러리는 안정적일 것으로 예상되며 라이브러리의 모든 업데이트는 이전 버전과의 호환성이 보장됩니다. 이전 버전과 호환되지 않는 모든 변경 사항은 주요 버전 증가(1.xy -> 2.0.0)로 이어집니다.

시사

미리보기 품질 수준에서 정의된 라이브러리는 여전히 작업이 진행 중이며 이전 버전과 호환되지 않는 업데이트를 받을 가능성이 더 높습니다. 또한 미리보기 라이브러리가 미리보기 또는 정식 버전으로 승격되기 전에 더 이상 사용되지 않고 삭제될 수 있습니다.

IDE 플러그인

IntelliJ 또는 Eclipse를 사용하는 경우 다음 IDE 플러그인을 사용하여 프로젝트에 클라이언트 라이브러리를 추가할 수 있습니다.

  • IntelliJ용 클라우드 도구
  • Eclipse용 클라우드 도구

클라이언트 라이브러리를 추가하는 것 외에도 플러그인은 서비스 계정 키 관리와 같은 추가 기능을 제공합니다. 자세한 내용은 각 플러그인의 설명서를 참조하세요.

이러한 클라이언트 라이브러리는 자바 8 런타임용 App Engine 표준 및 App Engine 가변형(Compat 런타임 포함)에서 사용할 수 있습니다. 대부분의 라이브러리는 자바 7 런타임용 App Engine 표준에서 작동하지 않습니다. 하지만 Datastore, Storage, BigQuery는 작동해야 합니다.

기여

이 라이브러리에 대한 기여는 언제나 환영하며 적극 권장됩니다.

시작하는 방법에 대한 자세한 내용은 google-cloud 의 CONTRIBUTING 문서 및 공유 문서를 참조하세요.

이 프로젝트는 기여자 행동 강령과 함께 출시되었습니다. 이 프로젝트에 참여함으로써 귀하는 해당 약관을 준수할 것에 동의하게 됩니다. 자세한 내용은 행동 강령을 참조하세요.

특허

Apache 2.0 - 자세한 내용은 라이센스를 참조하세요.

확장하다
추가 정보
관련 애플리케이션
추천
관련 정보 전체