클라이언트 라이브러리 설치

클라이언트 라이브러리 또는 REST를 설치하고 구성하는 방법은 다음과 같습니다.

기본 요건

클라이언트 라이브러리를 설치하기 전에 API 액세스 설정의 단계를 완료합니다. 여기에는 애플리케이션 기본 사용자 인증 정보 (ADC) 구성이 포함됩니다.

설치 단계

로컬 머신에서 원하는 클라이언트 라이브러리를 설치합니다.

REST

  1. 다음 샘플에서 OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID, AUDIENCE_ID와 같은 자리표시자를 계정 및 대상의 값으로 업데이트합니다.
  2. PROJECT_ID를 Google Cloud의 ID로 바꿉니다.

  3. 샘플을 명령줄에 복사하여 요청을 보냅니다. 파트너 링크를 통해 운영 계정에 액세스하는 경우에만 데이터 파트너 샘플을 사용합니다. 그렇지 않은 경우 광고주 샘플을 사용합니다.

    광고주

    #!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account then the command that
# specifies --scopes fails, so this sample falls back to the command
# without the --scopes argument.
DATA_MANAGER_ACCESS_TOKEN="$(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager || \
gcloud auth application-default print-access-token)"

# Fetches and prints the scope information for the access token. If you
# get scope-related errors when you send the request in the next step,
# verify that this output includes the Data Manager API scope:
#   https://www.googleapis.com/auth/datamanager
curl https://www.googleapis.com/oauth2/v1/tokeninfo?access_token="${DATA_MANAGER_ACCESS_TOKEN}"

# Sends the request.
curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
--header "Authorization: Bearer ${DATA_MANAGER_ACCESS_TOKEN}" \
--header "x-goog-user-project: PROJECT_ID" \
--header "Content-Type: application/json" \
--data @- <<EOF
{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_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

    데이터 파트너

    #!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account then the command that
# specifies --scopes fails, so this sample falls back to the command
# without the --scopes argument.
DATA_MANAGER_ACCESS_TOKEN="$(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager || \
gcloud auth application-default print-access-token)"

# Fetches and prints the scope information for the access token. If
# you get scope-related errors when you send the request in the next
# step, verify that this output includes the Data Manager API scope:
#   https://www.googleapis.com/auth/datamanager
curl https://www.googleapis.com/oauth2/v1/tokeninfo?access_token="${DATA_MANAGER_ACCESS_TOKEN}"

# Sends the request.
curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
--header "Authorization: Bearer ${DATA_MANAGER_ACCESS_TOKEN}" \
--header "x-goog-user-project: PROJECT_ID" \
--header "Content-Type: application/json" \
--data @- <<EOF
{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },
      "linkedAccount": {
        "accountType": "LINKED_ACCOUNT_TYPE",
        "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

.NET

클라이언트 라이브러리 설치

.NET 클라이언트 라이브러리 설치 가이드의 안내에 따라 프로젝트의 클라이언트 라이브러리에 종속 항목을 추가합니다.

선택사항: 유틸리티 라이브러리 및 코드 샘플 가져오기

  1. GitHub 저장소를 클론합니다.

    git clone https://github.com/googleads/data-manager-dotnet.git

  2. .NET 프로젝트에서 유틸리티 라이브러리에 ProjectReference 종속 항목을 선언합니다. PATH_TO_UTILITY_LIBRARY를 data-manager-dotnet 저장소를 클론한 위치로 바꿉니다.

    <ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />

  3. 데이터 형식을 지정하려면 .NET 프로젝트에서 Formatter 유틸리티를 사용합니다.

  4. samples 하위 디렉터리 또는 GitHub에서 코드 샘플을 찾아봅니다.

    samples 디렉터리로 변경하고 dotnet run을 사용하여 사용 가능한 샘플 목록을 가져옵니다.

    dotnet run

    샘플을 실행할 때 --help 인수를 전달하여 예상 매개변수가 포함된 사용법 문을 출력합니다.

    dotnet run -- ingest-audience-members --help

    샘플 데이터를 시작하려면 samples/sampledata/audience_members_1.csv의 파일을 사용합니다.

자바

클라이언트 라이브러리 설치

Java 클라이언트 라이브러리 설치 가이드의 안내에 따라 프로젝트의 클라이언트 라이브러리에 종속 항목을 추가합니다.

선택사항: 유틸리티 라이브러리 및 코드 샘플 가져오기

  1. GitHub 저장소를 클론합니다.

    git clone https://github.com/googleads/data-manager-java.git

  2. data-manager-java 디렉터리로 이동합니다.

  3. 유틸리티 라이브러리를 빌드하고 로컬 Maven 저장소에 게시합니다.

    ./gradlew data-manager-util:install

  4. Java 프로젝트에서 유틸리티 라이브러리에 종속 항목을 선언합니다.

    Gradle:

    implementation 'com.google.api-ads:data-manager-util:0.2.0'

    Maven:

    <dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.2.0</version>
</dependency>

  5. 데이터 형식을 지정하고 암호화하려면 Java 프로젝트에서 UserDataFormatter 및 Encrypter 유틸리티를 사용합니다.

  6. data-manager-samples 하위 디렉터리 또는 GitHub에서 코드 샘플을 찾아봅니다. 명령줄에서 샘플을 실행하려면 Gradle run 작업을 사용합니다.

    예를 들어 다음 명령어는 IngestAudienceMembers 샘플을 실행하고 사용법 문을 출력합니다.

    ./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'

    샘플 데이터를 시작하려면 data-manager-samples/src/main/resources/sampledata/audience_members_1.csv의 파일을 사용합니다.

Node.js

클라이언트 라이브러리 설치

Node.js 클라이언트 라이브러리 설치 가이드의 안내에 따라 프로젝트의 @google-ads/datamanager 클라이언트 라이브러리에 종속 항목을 추가합니다.

선택사항: 유틸리티 라이브러리 및 코드 샘플 가져오기

  1. GitHub 저장소를 클론합니다.

    git clone https://github.com/googleads/data-manager-node.git

  2. data-manager-node 디렉터리로 이동합니다.

  3. 다음 명령어를 실행하여 종속 항목을 설치합니다.

    npm install

  4. util 디렉터리로 변경합니다.

    cd util

  5. 다음 명령어를 실행하여 유틸리티 라이브러리를 컴파일하고 npm과 함께 사용할 .tgz 파일로 패킹합니다.

    npm pack

    이 명령어는 google-ads-datamanager-util-0.2.0.tgz라는 보관 파일을 생성합니다. 다음 단계에서 사용할 수 있도록 파일 위치를 기록해 둡니다.

  6. Node.js 프로젝트에서 google-ads-datamanager-util-0.2.0.tgz 파일의 전체 경로 및 파일 이름에 대한 dependencies 항목을 추가하여 Data Manager API 유틸리티 라이브러리에 종속 항목을 선언합니다.

    {
   "dependencies": {
      ...
      "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.2.0.tgz",
      ...
   }
}

    데이터 형식을 지정하려면 Node.js 프로젝트에서 UserDataFormatter 유틸리티를 사용합니다.

  7. samples 하위 디렉터리 또는 GitHub에서 코드 샘플을 찾아봅니다. 다음 단계에 따라 샘플을 실행합니다.

    1. data-manager-node 디렉터리로 이동합니다.

    2. 필요한 인수를 전달하여 샘플을 실행합니다. 샘플을 실행할 때 --help 인수를 전달하여 예상 매개변수가 포함된 사용법 문을 출력합니다.

      예를 들어 다음 명령어는 ingest_audience_members 샘플을 실행하고 사용법 문을 출력합니다.

      npm run ingest-audience-members -w samples -- --help

    샘플 데이터를 시작하려면 samples/sampledata/audience_members_1.csv의 파일을 사용합니다.

PHP

클라이언트 라이브러리 설치

PHP 클라이언트 라이브러리 설치 가이드의 안내에 따라 프로젝트의 googleads/data-manager 클라이언트 라이브러리에 종속 항목을 추가합니다.

선택사항: 유틸리티 라이브러리 및 코드 샘플 가져오기

  1. GitHub 저장소를 클론합니다.

    git clone https://github.com/googleads/data-manager-php.git

  2. data-manager-php 디렉터리로 이동합니다.

  3. 다음 명령어를 실행하여 라이브러리의 종속 항목을 확인합니다.

    composer update --prefer-dist

  4. 동일한 호스트의 PHP 프로젝트에 있는 composer.json 파일에서 다음 단계에 따라 유틸리티 라이브러리에 종속 항목을 선언합니다.

    1. data-manager-php 디렉터리의 위치를 가리키는 항목을 repositories 섹션에 추가합니다.

      "repositories" : [
   {
      "type" : "path",
      "url" : "PATH_TO_UTILITY_LIBRARY"
   }
]

    2. 유틸리티 라이브러리에 종속 항목을 선언합니다.

      "require": {
   "googleads/data-manager-util": "@dev"
}

    데이터 형식을 지정하려면 PHP 프로젝트에서 Formatter 유틸리티를 사용합니다.

  5. samples 하위 디렉터리 또는 GitHub에서 코드 샘플을 찾아봅니다. 다음 단계에 따라 샘플을 실행합니다.

    1. samples 디렉터리로 이동합니다.

    2. 다음 명령어를 실행하여 라이브러리의 종속 항목을 확인합니다.

      composer update --prefer-dist

    3. 필요한 인수를 전달하여 샘플을 실행합니다. 샘플을 실행할 때 --help 인수를 전달하여 예상 매개변수가 포함된 사용법 문을 출력합니다.

    샘플 데이터를 시작하려면 samples/sampledata/audience_members_1.csv의 파일을 사용합니다.

Python

클라이언트 라이브러리 설치

Python 클라이언트 라이브러리 설치 가이드의 안내에 따라 프로젝트의 google-ads-datamanager 클라이언트 라이브러리에 종속 항목을 추가합니다.

선택사항: 유틸리티 라이브러리 및 코드 샘플 가져오기

  1. GitHub 저장소를 클론합니다.

    git clone https://github.com/googleads/data-manager-python.git

  2. data-manager-python 디렉터리로 이동합니다.

  3. Python 환경에 유틸리티 라이브러리를 설치하려면 다음 명령어를 실행합니다.

    pip install .

  4. Python 프로젝트에서 유틸리티 라이브러리에 종속 항목을 선언합니다. 예를 들어 프로젝트에서 requirements.txt 파일을 사용하는 경우 다음 줄을 파일에 추가합니다.

    google-ads-datamanager-util=0.2.0

  5. 데이터 형식을 지정하고 암호화하려면 Python 프로젝트에서 Formatter 및 Encrypter 유틸리티를 사용합니다.

  6. samples 하위 디렉터리 또는 GitHub에서 코드 샘플을 찾아봅니다. 샘플을 실행하려면 필요한 종속 항목을 설치합니다.

    pip install .[samples]

    샘플을 실행할 때 --help 인수를 전달하여 예상 매개변수가 포함된 사용법 문을 출력합니다.

    샘플 데이터를 시작하려면 samples/sampledata/audience_members_1.csv의 파일을 사용합니다.

Ruby

클라이언트 라이브러리 설치

Ruby 클라이언트 라이브러리 설치 가이드의 안내에 따라 프로젝트의 클라이언트 라이브러리에 종속 항목을 추가합니다.

다음 단계

이전
API 액세스 설정