The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out this form.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

API 액세스 설정

다음은 SDK 또는 REST를 사용하여 Data Manager API에 대한 액세스를 설정하는 방법입니다.

Google Cloud 명령줄 인터페이스 설정

Google Cloud 명령줄 인터페이스를 설치하고 초기화합니다.
gcloud 구성요소가 최신 상태인지 확인하려면 다음 명령어를 실행합니다.
```
gcloud components update
```
(선택사항) gcloud config set 명령어를 사용하여 기본 프로젝트 및 리전을 설정합니다.

인증 설정

사용자 계정 및 서비스 계정으로 인증할 수 있습니다.

사용자 계정: Google API 및 서비스와 직접 상호작용하는 사용자를 나타냅니다.
서비스 계정: 사용자로 사람이 아닌 앱을 나타냅니다. 이를 통해 앱에서 인증 및 승인을 관리할 수 있습니다. 예를 들어 앱이 Google Cloud 리소스에 액세스해야 하는 경우

통합은 애플리케이션 기본 사용자 인증 정보 (ADC)를 사용하여 환경에서 사용자 인증 정보를 자동으로 찾을 수 있습니다. 인증하기 위해 클라이언트 코드를 변경할 필요는 없습니다.

사용자 계정 또는 서비스 계정을 선택하여 ADC를 설정합니다.

앱의 인증 및 사용자 인증 정보에 대해 자세히 알아보려면 Google의 인증 방법 및 애플리케이션 기본 사용자 인증 정보 설정을 참고하세요.

운영 계정 액세스 설정

사용자 또는 서비스 계정과 연결된 이메일에 Destination에 대한 액세스 권한을 부여합니다.

프로그래밍 언어의 SDK 설정

로컬 머신에서 원하는 SDK를 설치합니다.

REST

다음 샘플의 자리표시자(예: OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID, AUDIENCE_ID)를 계정 및 대상의 값으로 업데이트합니다.
PROJECT_ID를 Google Cloud의 ID로 바꿉니다.

샘플을 명령줄에 복사하여 요청을 보냅니다.

기존 제품 링크를 사용하여 operationAccount에 액세스하지 않는 경우 destinations의 항목에서 linkedAccount 속성을 삭제합니다.

#!/bin/bash
curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
  --header "Authorization: Bearer $(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager)" \
  --header "x-goog-user-project: PROJECT_ID" \
  --header "Content-Type: application/json" \
  --data @- &lt;&lt;EOF
{
  "destinations": [
    {
      "operatingAccount": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "product": "LOGIN_ACCOUNT_PRODUCT",
        "accountId": "LOGIN_ACCOUNT_ID"
      },
      "linkedAccount": {
        "product": "LINKED_ACCOUNT_PRODUCT",
        "accountId": "LINKED_ACCOUNT_ID"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ],
  "audienceMembers": [
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
          },
          {
            "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
          },
          {
            "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
          },
          {
            "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
          },
          {
            "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
          },
          {
            "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
          }
        ]
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

자바

google-cloud-ads-datamanager-v1-java.tar.gz를 다운로드하고 압축을 풉니다.
google-cloud-ads-datamanager-v1-java 디렉터리로 이동합니다.
다음 명령어를 실행하여 Maven 또는 Gradle과 함께 사용할 수 있도록 라이브러리를 빌드하고 로컬 Maven 저장소에 게시합니다.
```
./gradlew -Pversion=0.1.0 install
```

Java 프로젝트에서 Data Manager API 라이브러리에 대한 종속 항목을 선언합니다.

Gradle:

implementation 'com.google.cloud:gapic-google-cloud-ads-datamanager-v1-java:0.1.0'

Maven:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>gapic-google-cloud-ads-datamanager-v1-java</artifactId>
  <version>0.1.0</version>
</dependency>

선택사항. 유틸리티 라이브러리 및 코드 샘플을 가져옵니다.
1. data-manager-java.tar.gz를 다운로드하여 추출합니다.
2. data-manager-java 디렉터리로 이동합니다.
3. Maven 또는 Gradle의 경우 다음 명령어를 실행합니다. 이 명령어는 유틸리티 라이브러리를 빌드하고 로컬 Maven 저장소에 게시합니다.
```
./gradlew data-manager-util:install
```
4. Java 프로젝트에서 유틸리티 라이브러리의 종속 항목을 선언합니다.
  
  Gradle:
```
implementation 'com.google.api-ads:data-manager-util:0.1.0'
```
  Maven:
```
<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.1.0</version>
</dependency>
```
5. 데이터 형식을 지정하고 암호화하려면 Java 프로젝트에서 UserDataFormatter 및 Encrypter 유틸리티를 사용하세요.
6. data-manager-samples 하위 디렉터리에서 코드 샘플을 살펴봅니다. 명령줄에서 샘플을 실행하려면 Gradle run 작업을 사용하세요.
  
  예를 들어 다음 명령어는 IngestAudienceMembers 샘플을 실행하고 사용 설명을 출력합니다.
```
./gradlew data-manager-samples:run \
  --args='IngestAudienceMembers --help'
```
  샘플 데이터를 시작하는 데 도움이 되도록 data-manager-samples/src/main/resources/sampledata/audience_members_1.csv의 파일을 사용하세요.

Python

ads-datamanager-v1-py.tar.gz를 다운로드합니다.
다운로드 디렉터리로 이동합니다.
다음 명령어를 실행하여 라이브러리를 빌드하고 동일한 Python 환경의 다른 프로젝트에서 사용할 수 있도록 합니다.
```
pip install ./ads-datamanager-v1-py.tar.gz
```
Python 프로젝트에서 Data Manager API 라이브러리의 종속 항목을 선언합니다. 예를 들어 프로젝트에서 requirements.txt 파일을 사용하는 경우 다음 줄을 파일에 추가합니다.
```
google-ads-data-manager=0.1.0
```
선택사항. 유틸리티 라이브러리 및 코드 샘플을 가져옵니다.
1. data-manager-python.tar.gz를 다운로드하여 추출합니다.
2. data-manager-python 디렉터리로 이동합니다.
3. Python 환경에 유틸리티 라이브러리를 설치하려면 다음 명령어를 실행합니다.
```
pip install .
```
4. Python 프로젝트에서 유틸리티 라이브러리의 종속 항목을 선언합니다. 예를 들어 프로젝트에서 requirements.txt 파일을 사용하는 경우 다음 줄을 파일에 추가합니다.
```
google-ads-data-manager-util=0.1.0
```
5. 데이터 형식을 지정하고 암호화하려면 Python 프로젝트에서 Formatter 및 Encrypter 유틸리티를 사용하세요.
6. samples 하위 디렉터리에서 코드 샘플을 살펴봅니다. 샘플을 실행할 때 --help 인수를 전달하여 예상되는 매개변수가 포함된 사용 문구를 출력합니다.
  
  샘플 데이터를 시작하는 데 도움이 되도록 samples/sampledata/audience_members_1.csv의 파일을 사용하세요.

Node.js

ads-datamanager-v1-nodejs.tar.gz를 다운로드하여 추출합니다.
ads-datamanager-v1-nodejs 디렉터리로 이동합니다.
다음 명령어를 실행하여 라이브러리를 컴파일하고 npm와 함께 사용할 수 있도록 .tgz 파일로 팩킹합니다.
```
npm install
npm pack
```
이 명령어는 google-cloud-datamanager-0.1.0.tgz라는 보관 파일을 생성합니다.
Node.js 프로젝트에서 google-cloud-datamanager-0.1.0.tgz 파일의 전체 경로와 파일 이름에 관한 dependencies 항목을 추가하여 Data Manager API 라이브러리의 종속 항목을 선언합니다.

PHP

google-cloud-ads-datamanager-v1-php.tar.gz를 다운로드하여 추출합니다.
google-cloud-ads-datamanager-v1-php 디렉터리로 이동합니다.
다음 명령어를 실행하여 라이브러리의 종속 항목을 확인합니다.
```
composer update --prefer-dist
```
동일한 호스트의 PHP 프로젝트 composer.json 파일에서 다음 단계에 따라 Data Manager API 라이브러리의 종속 항목을 선언합니다.

a. google-cloud-ads-datamanager-v1-php 디렉터리의 위치를 가리키는 repositories 섹션을 추가합니다.
```
 "repositories" : [
    {
       "type" : "path",
       "url" : "PATH_TO_LIBRARY"
    }
 ]
```
b. Data Manager API 라이브러리에 대한 종속 항목을 선언합니다.
```
 "require": {
    "googleads/data-manager": "^0.1.0"
 }
```