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

วิธีตั้งค่าสิทธิ์เข้าถึง Data Manager API ด้วย SDK หรือ REST มีดังนี้

ข้อกำหนดเบื้องต้น

ก่อนที่จะใช้ Data API ได้ โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้

  1. โปรเจ็กต์ Google Cloud
  2. บัญชี Google ที่ตรงตามเกณฑ์ทั้ง 2 ข้อต่อไปนี้
    1. ได้รับสิทธิ์เข้าถึง Data Manager API หลังจากที่คุณกรอกแบบฟอร์มแสดงความสนใจ Data Manager API หากเห็นหน้าข้อมูลผลิตภัณฑ์ API แสดงว่าคุณมีสิทธิ์เข้าถึง
    2. มีserviceusage.services.enableสิทธิ์ในโปรเจ็กต์ Google Cloud หรือมีบทบาทที่มีสิทธิ์ดังกล่าว ตัวอย่างเช่น roles/owner และ roles/serviceusage.serviceUsageAdmin มีสิทธิ์ serviceusage.services.enable ทั้งคู่ หากต้องการตรวจสอบสิทธิ์ ให้ดูดูสิทธิ์เข้าถึงปัจจุบัน

เปิดใช้ API

เปิดใช้ Data Manager API หากยังไม่ได้ดำเนินการ

หากไม่พบ Data Manager API ให้ตรวจสอบว่าบัญชี Google ของคุณมีคุณสมบัติตรงตามข้อกำหนดเบื้องต้น

ตั้งค่าการตรวจสอบสิทธิ์

เลือกและตั้งค่าวิธีการตรวจสอบสิทธิ์ เราขอแนะนำให้คุณตั้งค่าข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันเพื่อค้นหาข้อมูลเข้าสู่ระบบจากสภาพแวดล้อมโดยอัตโนมัติ API นี้ไม่ได้ใช้คีย์ API

ต้องมีขอบเขต https://www.googleapis.com/auth/datamanager สำหรับข้อมูลเข้าสู่ระบบที่ใช้กับ Data Manager API ดูตัวอย่างวิธีใช้ขอบเขตได้ในเอกสารประกอบสำหรับคำสั่ง gcloud auth application-default login

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และข้อมูลเข้าสู่ระบบสำหรับแอปได้ที่วิธีการตรวจสอบสิทธิ์ที่ Google และวิธีการทำงานของข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชัน

ตั้งค่าสิทธิ์เข้าถึงบัญชีปฏิบัติการ

ให้สิทธิ์เข้าถึง Destination แก่อีเมลที่เชื่อมโยงกับบัญชีผู้ใช้หรือบัญชีบริการ

ตั้งค่า SDK สำหรับภาษาโปรแกรม

ติดตั้ง SDK ที่ต้องการในเครื่องของคุณ

REST

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

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

    #!/bin/bash
    
    # Uses gcloud to get an access token.
    DATA_MANAGER_ACCESS_TOKEN="$(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager)"
    
    # 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": {
            "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
    

Java

  1. ดาวน์โหลดและแตกไฟล์ google-cloud-ads-datamanager-v1-java.tar.gz
  2. ไปที่ไดเรกทอรี google-cloud-ads-datamanager-v1-java
  3. เรียกใช้คำสั่งต่อไปนี้เพื่อสร้างและเผยแพร่ไลบรารีไปยัง ที่เก็บ Maven ในเครื่องเพื่อใช้กับ Maven หรือ Gradle

    ./gradlew -Pversion=0.1.0 install
    
  4. ในโปรเจ็กต์ Java ให้ประกาศทรัพยากร Dependency ในไลบรารี 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>
    
  5. ไม่บังคับ รับไลบรารียูทิลิตีและตัวอย่างโค้ด

    1. ดาวน์โหลดและแตกไฟล์ data-manager-java.tar.gz
    2. ไปที่ไดเรกทอรี data-manager-java
    3. สำหรับ Maven หรือ Gradle ให้เรียกใช้คำสั่งต่อไปนี้ คำสั่งนี้ สร้างและเผยแพร่ไลบรารียูทิลิตีไปยัง ที่เก็บ 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 หากต้องการเรียกใช้ ตัวอย่างจากบรรทัดคำสั่ง ให้ใช้runงาน Gradle

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

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

      หากต้องการช่วยให้คุณเริ่มต้นใช้งานข้อมูลตัวอย่างได้ ให้ใช้ไฟล์ที่ data-manager-samples/src/main/resources/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.0
    
  5. ไม่บังคับ รับไลบรารียูทิลิตีและตัวอย่างโค้ด

    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

Node.js

  1. ดาวน์โหลดและแตกไฟล์ ads-datamanager-v1-nodejs.tar.gz
  2. ไปที่ไดเรกทอรี ads-datamanager-v1-nodejs
  3. เรียกใช้คำสั่งต่อไปนี้เพื่อคอมไพล์และแพ็กไลบรารีลงในไฟล์ .tgz เพื่อใช้กับ npm

    npm install
    npm pack
    

    คำสั่งจะสร้างที่เก็บถาวรชื่อ google-cloud-datamanager-0.1.0.tgz

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

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.0"
      }
      
  5. (ไม่บังคับ) รับไลบรารียูทิลิตีและตัวอย่างโค้ด

    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