ตั้งค่าการเข้าถึง API

REST

1. อัปเดตตัวยึดตำแหน่งในตัวอย่างต่อไปนี้ เช่น OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID และ AUDIENCE_ID ด้วยค่าสำหรับบัญชีและปลายทางของคุณ
2. แทนที่ PROJECT_ID ด้วยรหัสของ Google Cloud

3. คัดลอกตัวอย่างไปยังบรรทัดคำสั่งเพื่อส่งคำขอ

   นำแอตทริบิวต์ linkedAccount ของรายการใน destinations ออกหากคุณไม่ได้เข้าถึง operatingAccount โดยใช้ลิงก์ผลิตภัณฑ์ที่สร้างไว้

   #!/bin/bash
   
   # Uses gcloud to get an access token. If the Application Default
   # Credentials aren't for a service account, the command that specifies
   # --scopes fails. 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. ดาวน์โหลดและแตกไฟล์ data-manager-dotnet.tar.gz

2. ในโปรเจ็กต์ .NET ให้ประกาศ ProjectReferenceDependency ใน ไลบรารียูทิลิตี แทนที่ PATH_TO_UTILITY_LIBRARY ด้วยตำแหน่งที่คุณแยกไดเรกทอรี data-manager-dotnet จาก data-manager-dotnet.tar.gz

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

3. หากต้องการจัดรูปแบบข้อมูล ให้ใช้ยูทิลิตี Formatter ในโปรเจ็กต์ .NET

4. เรียกดูตัวอย่างโค้ดในไดเรกทอรีย่อย samples

   เปลี่ยนไปที่ไดเรกทอรี samples แล้วใช้ dotnet run เพื่อดูรายการ ตัวอย่างที่มี

   dotnet run
   

   ส่งอาร์กิวเมนต์ --help เมื่อเรียกใช้ตัวอย่างเพื่อพิมพ์คำสั่งการใช้งาน พร้อมพารามิเตอร์ที่คาดไว้

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

   หากต้องการช่วยให้คุณเริ่มต้นใช้งานข้อมูลตัวอย่างได้ ให้ใช้ไฟล์ที่ samples/sampledata/audience_members_1.csv

Java

ติดตั้งไลบรารีของไคลเอ็นต์

1. ดาวน์โหลดและแตกไฟล์ google-cloud-ads-datamanager-v1-java.tar.gz
2. ไปที่ไดเรกทอรี google-cloud-ads-datamanager-v1-java

3. เรียกใช้คำสั่งต่อไปนี้เพื่อสร้างและเผยแพร่ไลบรารีไปยัง ที่เก็บ Maven ในเครื่องเพื่อใช้กับ Maven หรือ Gradle

   ./gradlew install
   

4. ในโปรเจ็กต์ Java ให้ประกาศทรัพยากร Dependency ในไลบรารี Data Manager API

   Gradle:

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

   Maven:

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

ไม่บังคับ: รับไลบรารียูทิลิตีและตัวอย่างโค้ด

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 ให้ประกาศทรัพยากร Dependency ในไลบรารียูทิลิตี

   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. หากต้องการจัดรูปแบบและเข้ารหัสข้อมูล ให้ใช้ยูทิลิตี UserDataFormatter และ Encrypter ในโปรเจ็กต์ Java

6. เรียกดูตัวอย่างโค้ดในdata-manager-samplesไดเรกทอรีย่อยหรือใน GitHub หากต้องการเรียกใช้ตัวอย่างจากบรรทัดคำสั่ง ให้ใช้run งาน Gradle

   เช่น คำสั่งต่อไปนี้จะเรียกใช้ IngestAudienceMembers sample และพิมพ์คำชี้แจงการใช้งาน

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

   หากต้องการช่วยให้คุณเริ่มต้นใช้งานข้อมูลตัวอย่างได้ ให้ใช้ไฟล์ที่ data-manager-samples/src/main/resources/sampledata/audience_members_1.csv

Node.js

ติดตั้งไลบรารีของไคลเอ็นต์

1. ดาวน์โหลดและแตกไฟล์ ads-datamanager-v1-nodejs.tar.gz
2. ไปที่ไดเรกทอรี ads-datamanager-v1-nodejs

3. เรียกใช้คำสั่งต่อไปนี้เพื่อคอมไพล์และแพ็กไลบรารีไคลเอ็นต์ลงในไฟล์ .tgz สำหรับใช้กับ npm

   npm pack
   

   คำสั่งจะสร้างที่เก็บถาวรชื่อ google-cloud-datamanager-0.1.4.tgz จดตำแหน่งไฟล์ไว้เพื่อใช้ในขั้นตอนถัดไป

4. ในโปรเจ็กต์ Node.js ให้ประกาศการอ้างอิงไลบรารีไคลเอ็นต์ Data Manager API โดยการเพิ่มรายการ dependencies สำหรับเส้นทางแบบเต็มและชื่อไฟล์ของไฟล์ google-cloud-datamanager-0.1.4.tgz

   {
      "dependencies": {
         ...
         "@google-cloud/datamanager": "file:PATH_TO_CLIENT_LIBRARY/google-cloud-datamanager-0.1.4.tgz",
         ...
      }
   }
   

ไม่บังคับ: รับไลบรารียูทิลิตีและตัวอย่างโค้ด

1. ดาวน์โหลดและแตกไฟล์ data-manager-node.tar.gz
2. ไปที่ไดเรกทอรี data-manager-node

3. เปลี่ยนเป็นไดเรกทอรี util

   cd util
   

4. เรียกใช้คำสั่งต่อไปนี้เพื่อคอมไพล์และแพ็กไลบรารียูทิลิตีเป็นไฟล์ .tgz สำหรับใช้กับ npm

   npm pack
   

   คำสั่งจะสร้างที่เก็บถาวรชื่อ google-ads-datamanager-util-0.1.0.tgz จดตำแหน่งไฟล์ไว้เพื่อใช้ในขั้นตอนถัดไป

5. ในโปรเจ็กต์ Node.js ให้ประกาศการอ้างอิงในไลบรารียูทิลิตี Data Manager API โดยการเพิ่มรายการ dependencies สำหรับเส้นทางแบบเต็มและ ชื่อไฟล์ของไฟล์ google-ads-datamanager-util-0.1.0.tgz

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

   หากต้องการจัดรูปแบบข้อมูล ให้ใช้UserDataFormatterยูทิลิตีในโปรเจ็กต์ Node.js

6. เรียกดูตัวอย่างโค้ดในไดเรกทอรีย่อย samples เรียกใช้ตัวอย่าง โดยทำตามขั้นตอนต่อไปนี้

   1. คัดลอก google-cloud-datamanager-0.1.4.tgz ไปยังไดเรกทอรีหลักของไดเรกทอรี data-manager-node

   2. ไปที่ไดเรกทอรี samples ใน data-manager-node

   3. เรียกใช้คำสั่งต่อไปนี้เพื่อคอมไพล์ตัวอย่าง

      npm run compile
      

   4. เรียกใช้ตัวอย่างโดยส่งอาร์กิวเมนต์ที่จำเป็น ส่งอาร์กิวเมนต์ --help เมื่อเรียกใช้ตัวอย่างเพื่อพิมพ์ข้อความการใช้งานพร้อมพารามิเตอร์ที่คาดไว้

      เช่น คำสั่งต่อไปนี้จะเรียกใช้ ingest_audience_members ตัวอย่างและพิมพ์คำชี้แจงการใช้งาน

      npx ts-node audiences/ingest_audience_members.ts --help
      

   หากต้องการช่วยให้คุณเริ่มต้นใช้งานข้อมูลตัวอย่างได้ ให้ใช้ไฟล์ที่ samples/sampledata/audience_members_1.csv

PHP

ติดตั้งไลบรารีของไคลเอ็นต์

1. ดาวน์โหลดและแตกไฟล์ google-cloud-ads-datamanager-v1-php.tar.gz
2. ไปที่ไดเรกทอรี google-cloud-ads-datamanager-v1-php

3. เรียกใช้คำสั่งต่อไปนี้เพื่อแก้ไขทรัพยากร Dependency สำหรับไลบรารี

   composer update --prefer-dist
   

4. ในไฟล์ composer.json ของโปรเจ็กต์ PHP ในโฮสต์เดียวกัน ให้ประกาศ การอ้างอิงในไลบรารี Data Manager API โดยทำตามขั้นตอนต่อไปนี้

   1. เพิ่มrepositoriesส่วนที่ชี้ไปยังตำแหน่งของgoogle-cloud-ads-datamanager-v1-phpไดเรกทอรี

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

   2. ประกาศทรัพยากร Dependency ในไลบรารี Data Manager API

      "require": {
         "googleads/data-manager": "0.1.4"
      }
      

ไม่บังคับ: รับไลบรารียูทิลิตีและตัวอย่างโค้ด

1. ดาวน์โหลดและแตกไฟล์ data-manager-php.tar.gz
2. ไปที่ไดเรกทอรี data-manager-php

3. เรียกใช้คำสั่งต่อไปนี้เพื่อแก้ไขทรัพยากร Dependency สำหรับไลบรารี

   composer update --prefer-dist
   

4. ในไฟล์ composer.json ของโปรเจ็กต์ PHP ในโฮสต์เดียวกัน ให้ประกาศทรัพยากร Dependency ในไลบรารียูทิลิตีโดยทำตามขั้นตอนต่อไปนี้

   1. เพิ่มรายการในส่วน repositories ที่ชี้ไปยัง ตำแหน่งของไดเรกทอรี data-manager-php

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

   2. ประกาศทรัพยากร Dependency ในไลบรารียูทิลิตี

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

   หากต้องการจัดรูปแบบข้อมูล ให้ใช้ยูทิลิตี Formatter ในโปรเจ็กต์ PHP

5. เรียกดูตัวอย่างโค้ดในไดเรกทอรีย่อย samples เรียกใช้ตัวอย่าง โดยทำตามขั้นตอนต่อไปนี้

   1. ไปที่ไดเรกทอรี samples

   2. ตั้งค่าตัวแปรสภาพแวดล้อม DATA_MANAGER_PHP_LIB เป็นเส้นทาง ที่คุณแยกไลบรารีของไคลเอ็นต์

      export DATA_MANAGER_PHP_LIB="PATH_TO_CLIENT_LIBRARY"
      

   3. เรียกใช้คำสั่งต่อไปนี้เพื่อแก้ไขทรัพยากร Dependency สำหรับไลบรารี

      composer update --prefer-dist
      

   4. เรียกใช้ตัวอย่างโดยส่งอาร์กิวเมนต์ที่จำเป็น ส่งอาร์กิวเมนต์ --help เมื่อเรียกใช้ตัวอย่างเพื่อพิมพ์ข้อความการใช้งานพร้อมพารามิเตอร์ที่คาดไว้

   หากต้องการช่วยให้คุณเริ่มต้นใช้งานข้อมูลตัวอย่างได้ ให้ใช้ไฟล์ที่ samples/sampledata/audience_members_1.csv

Python

ติดตั้งไลบรารีของไคลเอ็นต์

1. ดาวน์โหลด ads-datamanager-v1-py.tar.gz
2. ไปที่ไดเรกทอรีของการดาวน์โหลด

3. เรียกใช้คำสั่งต่อไปนี้เพื่อสร้างไลบรารีและทำให้พร้อมใช้งานสำหรับ โปรเจ็กต์อื่นๆ ในสภาพแวดล้อม Python เดียวกัน

   pip install ./ads-datamanager-v1-py.tar.gz
   

4. ในโปรเจ็กต์ Python ให้ประกาศการอ้างอิงไลบรารี Data Manager API ตัวอย่างเช่น หากใช้ไฟล์ requirements.txt ในโปรเจ็กต์ ให้เพิ่มบรรทัดต่อไปนี้ลงในไฟล์

   google-ads-data-manager=0.1.4
   

ไม่บังคับ: รับไลบรารียูทิลิตีและตัวอย่างโค้ด

1. ดาวน์โหลดและแตกไฟล์ data-manager-python.tar.gz
2. ไปที่ไดเรกทอรี data-manager-python

3. หากต้องการติดตั้งไลบรารียูทิลิตีในสภาพแวดล้อม Python ให้เรียกใช้คำสั่งต่อไปนี้

   pip install .
   

4. ในโปรเจ็กต์ Python ให้ประกาศทรัพยากร Dependency ในไลบรารียูทิลิตี ตัวอย่างเช่น หากใช้ไฟล์ requirements.txt ในโปรเจ็กต์ ให้เพิ่มบรรทัดต่อไปนี้ลงในไฟล์

   google-ads-data-manager-util=0.1.0
   

5. หากต้องการจัดรูปแบบและเข้ารหัสข้อมูล ให้ใช้ยูทิลิตี Formatter และ Encrypter ในโปรเจ็กต์ Python

6. เรียกดูตัวอย่างโค้ดในไดเรกทอรีย่อย samples ส่งอาร์กิวเมนต์ --help เมื่อเรียกใช้ตัวอย่างเพื่อพิมพ์ข้อความการใช้งานพร้อมพารามิเตอร์ที่คาดไว้

   หากต้องการช่วยให้คุณเริ่มต้นใช้งานข้อมูลตัวอย่างได้ ให้ใช้ไฟล์ที่ samples/sampledata/audience_members_1.csv

Ruby

ติดตั้งไลบรารีของไคลเอ็นต์

ทำตามวิธีการในคู่มือการติดตั้งไลบรารีของไคลเอ็นต์ Ruby เพื่อเพิ่มการอ้างอิงไปยังไลบรารีของไคลเอ็นต์ในโปรเจ็กต์