코드 샘플 실행

cURL

설정

1. API 문서의 안내에 따라 앱의 프로젝트를 만들거나 선택하고 API를 사용 설정합니다.
2. Cloud Console에서 API 키를 만듭니다.
3. Cloud Console에서 웹 애플리케이션의 OAuth 클라이언트 ID 사용자 인증 정보를 만들고 https://developers.google.com/oauthplayground을 리디렉션 URI로 사용합니다.
4. OAuth 2.0 Playground에서 OAuth 2.0 구성 settings을 클릭합니다.
5. 자체 사용자 인증 정보 사용을 선택합니다.
6. 3단계에서 생성된 클라이언트 ID와 클라이언트 보안 비밀번호를 입력합니다.
7. 범위 필드에 메서드에 사용할 범위를 입력하고 API 승인을 클릭합니다.
8. (선택사항) 로그인 화면이 표시되면 사용할 계정을 선택합니다.
9. (선택사항) 승인 화면이 표시되면 수락을 클릭합니다.
10. 토큰에 대한 승인 코드 교환을 클릭합니다. 토큰이 반환됩니다.
11. cURL 코드 샘플에서 [YOUR_API_KEY]를 2단계에서 생성된 API 키로 바꿉니다. 'https://www.googleapis.com/drive/v3/files?key=[YOUR_API_KEY]' \
12. cURL 코드 샘플에서 [YOUR_ACCESS_TOKEN]을 10단계에서 생성된 액세스 토큰으로 바꿉니다. --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \

코드 샘플 실행

명령줄에서 cURL 명령어를 실행합니다. 명령어는 다음과 유사합니다.

curl \
'https://www.googleapis.com/drive/v3/files?key=AIzaSyBiKcaoXmVApwnT24hitQG_dwjGvAj6Ddw' \
--header 'Authorization: Bearer ya29.a0ARrdaM_yQn9MWBpJgKPx880BSnRYIizRYIDz0JN9e66nSliIYpqNXmPsvv2ccfplCTG_U4b1' \
--header 'Accept: application/json' \
--compressed

자바스크립트

설정

1. API 문서의 안내에 따라 앱의 프로젝트를 만들거나 선택하고 API를 사용 설정합니다.
2. Cloud Console에서 API 키를 만듭니다.
3. Cloud Console에서 '웹 애플리케이션'을 위한 OAuth 클라이언트 ID 사용자 인증 정보를 만들고, 승인된 자바스크립트 원본을 설정하여 요청을 보낼 URL을 식별합니다(예: http://localhost).
4. 전체 코드 샘플을 웹 서버에 액세스할 수 있는 로컬 파일(예: /var/www/html/example.html)에 복사합니다.

5. 코드 샘플에서 API 키 또는 클라이언트 ID를 설정하는 줄을 찾아 값을 2단계와 3단계에서 생성된 값으로 바꿉니다.

   • API 키: gapi.client.setApiKey(YOUR_API_KEY);
   • OAuth 2.0 클라이언트 ID: gapi.client.init({ 'clientId': 'YOUR_CLIENT_ID',

코드 샘플 실행

1. 브라우저에서 파일(예: http://localhost/example.html)을 엽니다. Chrome과 같은 디버깅 콘솔이 있는 브라우저를 사용하는 것이 좋습니다.
2. (선택사항) 로그인 화면이 표시되면 사용할 계정을 선택합니다.
3. (선택사항) 승인 화면이 표시되면 수락을 클릭합니다. 디버깅 콘솔에 메서드 응답이 JSON 객체로 표시됩니다.

자바

기본 요건

• 자바 1.7 이상
• Gradle 7 이상

설정

1. API 문서의 안내에 따라 앱의 프로젝트를 만들거나 선택하고 API를 사용 설정합니다.
2. 메서드에서 액세스하는 데이터 유형에 따라 API 키 (공개 데이터)를 만들거나 OAuth 2.0 클라이언트 ID (비공개 데이터)를 만듭니다.
3. 애플리케이션 유형을 데스크톱 앱으로 설정합니다.
4. OAuth 2.0 클라이언트 ID를 만든 경우 OAuth 2.0 사용자 인증 정보가 포함된 JSON 파일을 다운로드합니다. 이 파일의 이름은 client_secret_CLIENTID.json과 비슷합니다. 여기서 CLIENTID는 프로젝트의 클라이언트 ID입니다.

5. 작업 디렉터리에서 다음 명령어를 실행하여 새 프로젝트 구조를 만듭니다.

   $ gradle init --type basic
   $ mkdir -p src/main/java src/main/resources
   

6. 2단계에서 OAuth 2.0 클라이언트 ID를 만든 경우 다운로드한 JSON 파일의 이름을 client_secret.json로 변경합니다.

7. 5단계에서 만든 src/main/resources 디렉터리에 이름이 변경된 파일을 저장합니다.

8. 작업 디렉터리에서 build.gradle 파일을 열고 콘텐츠를 다음으로 바꿉니다.

   apply plugin: 'java'
   apply plugin: 'application'
   
   mainClassName = 'ApiExample'
   sourceCompatibility = 1.7
   targetCompatibility = 1.7
   version = '1.0'
   
   repositories {
       mavenCentral()
   }
   
   dependencies {
       compile 'com.google.api-client:google-api-client:1.23.0'
       compile 'com.google.oauth-client:google-oauth-client-jetty:1.23.0'
       API_SPECIFIC_DEPENDENCY
   }
   

9. build.gradle 파일에서 API_SPECIFIC_DEPENDENCY라는 줄을 호출하는 API의 코드를 컴파일하는 안내로 바꿉니다. 다음은 YouTube Analytics API의 샘플입니다.

   compile 'com.google.apis:google-api-services-youtubeAnalytics:v2-rev16-1.23.0'
   

   안내는 다음 템플릿을 따릅니다.

   compile 'com.google.apis:google-api-services-API_NAME:API_VERSION-   revREVISION-CL_VERSION'
   

각 항목의 의미는 다음과 같습니다.

• API_NAME은 API의 GitHub에 나열된 API 이름입니다. 이름을 찾으려면 지원되는 Google API 페이지에서 API 옆에 있는 버전 링크를 클릭합니다. 버전 링크는 GitHub로 이동합니다. API 이름은 페이지 가운데에 위치하고 앞에 googleapis/google-apis-services-이 옵니다. 예를 들어 Drive API v3의 경우 API_NAME은 drive입니다.
• API_VERSION는 지원되는 Google API 페이지의 API 이름 아래에 나열된 API 버전입니다.
• REVISION는 API의 JavaDoc 참조에 나열된 버전 번호입니다. JavaDoc 참조는 https://googleapis.dev/java/google-api-services-API_NAME/latest/index.html에서 확인할 수 있습니다.
• CL_VERSION은 클라이언트 라이브러리 버전입니다. 이 값은 JavaDoc 참조에도 표시됩니다.
• 작업 디렉터리에서 API 탐색기의 코드 샘플을 src/main/java/ApiExample.java에 복사합니다. 각 샘플의 클래스 이름은 ApiExample이므로 다른 샘플을 실행하기 위해 build.gradle 파일을 수정할 필요가 없습니다.

코드 샘플 실행

다음 명령어를 사용하여 예시를 실행합니다.

  gradle -q run

샘플은 API 요청을 실행하고 STDOUT에 응답을 출력합니다. 호출하는 서비스를 확인하여 데이터를 쓰는 요청의 효과를 확인할 수도 있습니다.

Node.js

기본 요건

• Node.js

• Node.js용 Google API 클라이언트 라이브러리:

  • 이전에 클라이언트 라이브러리를 설치하지 않았다면 다음 명령어를 실행합니다.

  npm install googleapis --save
  

  • 이전에 클라이언트 라이브러리를 설치했다면 테스트 중인 라이브러리의 최신 클래스가 포함되도록 클라이언트 라이브러리를 업데이트하는 것이 좋습니다. 클라이언트 라이브러리를 업데이트하려면 다음 명령어를 실행합니다.

  npm update googleapis --save
  

설정

1. API 문서의 안내에 따라 앱의 프로젝트를 만들거나 선택하고 API를 사용 설정합니다.
2. 메서드에서 액세스하는 데이터 유형에 따라 API 키 (공개 데이터)를 만들거나 OAuth 2.0 클라이언트 ID (비공개 데이터)를 만듭니다.
3. 애플리케이션 유형을 데스크톱 앱으로 설정합니다.
4. OAuth 2.0 클라이언트 ID를 만든 경우 OAuth 2.0 사용자 인증 정보가 포함된 JSON 파일을 다운로드합니다. 이 파일의 이름은 client_secret_CLIENTID.json과 비슷합니다. 여기서 CLIENTID는 프로젝트의 클라이언트 ID입니다.
5. 코드 샘플을 로컬 파일에 복사하고 샘플을 수정하여 API 키 또는 클라이언트 보안 비밀 파일을 올바르게 식별합니다. 샘플에서 API 키 값은 YOUR_API_KEY이고 클라이언트 보안 비밀 파일 위치는 YOUR_CLIENT_SECRET_FILE.json입니다.

코드 샘플 실행

다음 명령어를 사용하여 예시를 실행합니다.

  node sample.js

대부분의 샘플은 STDOUT에 API 응답 (또는 다른 항목)을 출력합니다.

PHP

기본 요건

• PHP 5.4 이상 명령줄 인터페이스 (CLI) 및 JSON 확장 프로그램
• 전역적으로 설치된 Composer 종속 항목 관리 도구

• PHP용 Google API 클라이언트 라이브러리:

  • 이전에 클라이언트 라이브러리를 설치하지 않았다면 다음 명령어를 실행합니다.

    composer require google/apiclient:^2.0
    

  • 이전에 클라이언트 라이브러리를 설치했다면 업데이트하는 라이브러리의 최신 버전이 있는지 확인하기 위해 업데이트하는 것이 좋습니다. 클라이언트 라이브러리를 업데이트하려면 다음 명령어를 실행합니다.

    composer update google/apiclient --with-dependencies
    

코드 샘플 실행

다음 명령어를 사용하여 예시를 실행합니다.

  php sample.php

대부분의 샘플은 STDOUT에 API 응답 (또는 다른 항목)을 출력합니다.

Python

기본 요건

• Python 2.7 또는 Python 3.5 이상
• pip 패키지 관리 도구

• Python용 Google API 클라이언트 라이브러리:

  pip install --upgrade google-api-python-client
  

• 사용자 승인을 위한 google-auth-oauthlib 및 google-auth-httplib2 라이브러리:

  pip install --upgrade google-auth-oauthlib google-auth-httplib2
  

설정

1. API 문서의 안내에 따라 앱의 프로젝트를 만들거나 선택하고 API를 사용 설정합니다.
2. 메서드에서 액세스하는 데이터 유형에 따라 API 키 (공개 데이터)를 만들거나 OAuth 2.0 클라이언트 ID (비공개 데이터)를 만듭니다.
3. 애플리케이션 유형을 데스크톱 앱으로 설정합니다.
4. OAuth 2.0 클라이언트 ID를 만든 경우 OAuth 2.0 사용자 인증 정보가 포함된 JSON 파일을 다운로드합니다. 이 파일의 이름은 client_secret_CLIENTID.json과 비슷합니다. 여기서 CLIENTID는 프로젝트의 클라이언트 ID입니다.
5. 코드 샘플을 로컬 파일에 복사하고 샘플을 수정하여 API 키 또는 클라이언트 보안 비밀 파일을 올바르게 식별합니다. 샘플에서 API 키 값은 YOUR_API_KEY이고 클라이언트 보안 비밀 파일 위치는 YOUR_CLIENT_SECRET_FILE.json입니다.

코드 샘플 실행

다음 명령어를 사용하여 예시를 실행합니다.

  python sample.py

대부분의 샘플은 STDOUT에 API 응답 (또는 다른 항목)을 출력합니다.

Ruby

기본 요건

• Ruby 2.0 이상

• Ruby용 Google API 클라이언트 라이브러리:

  gem install google-api-client`
  

설정

1. API 문서의 안내에 따라 앱의 프로젝트를 만들거나 선택하고 API를 사용 설정합니다.
2. 메서드에서 액세스하는 데이터 유형에 따라 API 키 (공개 데이터)를 만들거나 OAuth 2.0 클라이언트 ID (비공개 데이터)를 만듭니다.
3. 애플리케이션 유형을 데스크톱 앱으로 설정합니다.
4. OAuth 2.0 클라이언트 ID를 만든 경우 OAuth 2.0 사용자 인증 정보가 포함된 JSON 파일을 다운로드합니다. 이 파일의 이름은 client_secret_CLIENTID.json과 비슷합니다. 여기서 CLIENTID는 프로젝트의 클라이언트 ID입니다.
5. 코드 샘플을 로컬 파일에 복사하고 샘플을 수정하여 API 키 또는 클라이언트 보안 비밀 파일을 올바르게 식별합니다. 샘플에서 API 키 값은 YOUR_API_KEY이고 클라이언트 보안 비밀 파일 위치는 YOUR_CLIENT_SECRET_FILE.json입니다.

코드 샘플 실행

다음 명령어를 사용하여 예시를 실행합니다.

  ruby sample.rb

대부분의 샘플은 STDOUT에 API 응답 (또는 다른 항목)을 출력합니다.