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

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

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

  1. โปรเจ็กต์ Google Cloud หรือบัญชี Google ที่คุณต้องการให้เป็นเจ้าของโปรเจ็กต์

    • หากไม่มีโปรเจ็กต์ กระบวนการตั้งค่าในส่วนถัดไปจะสร้างโปรเจ็กต์ให้คุณ

    • หากมีโปรเจ็กต์อยู่แล้ว ให้ตรวจสอบว่าบัญชี Google ของคุณมีบทบาทที่สามารถเปิดใช้ API ในโปรเจ็กต์ได้ เช่น เจ้าของ ผู้แก้ไข หรือผู้ดูแลระบบการใช้งานบริการ หากต้องการตรวจสอบบทบาท ให้เปิดหน้า IAM ในคอนโซล Google Cloud เลือกโปรเจ็กต์ แล้วค้นหาบัญชี Google ในรายการ

      โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อดูสิทธิ์เข้าถึงปัจจุบัน

  2. ติดตั้ง Google Cloud CLI แล้ว

เปิดใช้ API

หากยังไม่ได้เปิดใช้ Data Manager API ในโปรเจ็กต์ Google Cloud ให้คลิกเปิดใช้ Data Manager API หรือทำตามวิธีการเพื่อทำขั้นตอนนี้ด้วยตนเอง

เปิดใช้ Data Manager API

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

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

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

วิธีการตรวจสอบสิทธิ์ที่พบบ่อย 2 วิธีคือบัญชีผู้ใช้และบัญชีบริการ

  • บัญชีผู้ใช้: แสดงถึงผู้ที่โต้ตอบกับ Google APIs และบริการต่างๆ โดยตรง
  • บัญชีบริการ: แสดงแอป ไม่ใช่บุคคล ในฐานะผู้ใช้ ซึ่งช่วยให้แอปจัดการการตรวจสอบสิทธิ์และการให้สิทธิ์ได้ เช่น หากแอปต้องการเข้าถึงทรัพยากร Google Cloud

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

เลือกบัญชีผู้ใช้หรือบัญชีบริการเพื่อตั้งค่า ADC ดังนี้

บัญชีผู้ใช้

ขั้นตอนในการตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบของบัญชีผู้ใช้มีดังนี้

  1. กำหนดการตั้งค่าแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google สำหรับโปรเจ็กต์

    1. เปิดหน้าการสร้างแบรนด์ในคอนโซล Google Cloud

    2. เลือกโปรเจ็กต์

    3. กรอกแบบฟอร์ม แล้วคลิกสร้าง

  2. เนื่องจาก Data Manager API ใช้ขอบเขตที่ละเอียดอ่อน คุณจึงต้องทำตามขั้นตอนต่อไปนี้

    1. ไปที่การตั้งค่าการเข้าถึงข้อมูลสำหรับโปรเจ็กต์ของคุณ

    2. คลิกเพิ่มหรือนำขอบเขตออก

    3. ในรายการขอบเขต ให้ค้นหา Data Manager API และเลือกช่องสำหรับแต่ละขอบเขตที่แอปพลิเคชันของคุณต้องการ ดังนี้

      • .../auth/datamanager: เลือกขอบเขตนี้สำหรับการดำเนินการ API มาตรฐาน เช่น การจัดการข้อมูลลูกค้า กลุ่มเป้าหมาย และเหตุการณ์ นี่คือขอบเขตหลักที่ใช้ตลอดทั้งคู่มือนี้

      • .../auth/datamanager.partnerlink: เลือกขอบเขตนี้เฉพาะในกรณีที่คุณเป็นพาร์ทเนอร์ด้านข้อมูลที่สร้างหรือลบลิงก์พาร์ทเนอร์ในบัญชีผู้ลงโฆษณา

    4. คลิกอัปเดต

    5. คลิกบันทึก

    6. ไปที่กลุ่มเป้าหมายในคอนโซล Google Cloud และกำหนดการตั้งค่าสำหรับการพัฒนาเบื้องต้น ดังนี้

      • ตั้งค่าสถานะการเผยแพร่เป็นการทดสอบ
      • ตั้งค่าประเภทผู้ใช้เป็นภายใน (หากโปรเจ็กต์อยู่ในองค์กร Google Workspace) หรือภายนอก (หากไม่ได้อยู่ในองค์กร Google Workspace)
      • หากใช้ภายนอก ให้เพิ่มบัญชี Google ที่คุณใช้สร้างข้อมูลเข้าสู่ระบบเป็นผู้ใช้ทดสอบ

      ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าเหล่านี้ในจัดการกลุ่มเป้าหมายของแอป

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

    หากคลิกสร้างไคลเอ็นต์ OAuth2 ให้เลือกแอปบนเดสก์ท็อปเมื่อระบบแจ้งให้กำหนดค่าไคลเอ็นต์ OAuth เพื่อให้คุณใช้ไคลเอ็นต์ในขั้นตอนที่เหลือได้

    สร้างไคลเอ็นต์ OAuth2

    ในขั้นตอนสุดท้าย ให้คลิกดาวน์โหลดการกำหนดค่าไคลเอ็นต์ และจดบันทึกตำแหน่งการดาวน์โหลดที่คุณเลือกไว้

  4. สร้างไฟล์ ADC ในเครื่องโดยเรียกใช้คำสั่งต่อไปนี้ คำสั่งนี้จะเปิดขั้นตอนบนเว็บซึ่งระบบจะแจ้งให้คุณเข้าสู่ระบบบัญชี Google ที่ใช้กับ API

    แทนที่ PATH_TO_CLIENT_JSON ด้วยชื่อไฟล์ JSON ที่คุณดาวน์โหลด

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    หากต้องการใช้ข้อมูลเข้าสู่ระบบเดียวกันสำหรับ Data Manager API และ Google Ads API ให้รวมขอบเขต Google Ads API ไว้ในรายการ --scopes ดังนี้

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    หากต้องการใช้ข้อมูลเข้าสู่ระบบเดียวกันสำหรับ Data Manager API และ Display & Video 360 API ให้รวมขอบเขต Display & Video 360 API ไว้ในรายการ --scopes ดังนี้

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

  5. ยืนยันว่าตั้งค่าข้อมูลเข้าสู่ระบบอย่างถูกต้องโดยใช้คำสั่งต่อไปนี้ หากสําเร็จ คําสั่งจะพิมพ์โทเค็นเพื่อการเข้าถึงไปยังคอนโซล

    gcloud auth application-default print-access-token

บัญชีบริการ

ขั้นตอนในการสร้างบัญชีบริการและใช้การแอบอ้างเป็นบัญชีบริการเพื่อตรวจสอบสิทธิ์ในสภาพแวดล้อมการพัฒนาซอฟต์แวร์ในเครื่องมีดังนี้ ขั้นตอนเหล่านี้ใช้การแอบอ้างเป็นบุคคลอื่นแทนคีย์บัญชีบริการ เนื่องจากคีย์บัญชีบริการอาจก่อให้เกิดความเสี่ยงด้านความปลอดภัยหากไม่ได้รับการจัดการอย่างระมัดระวัง

  1. คลิกปุ่มสร้างบัญชีบริการต่อไปนี้ หรือทำตามวิธีการเพื่อเลือกหรือสร้างบัญชีบริการ

    สร้างบัญชีบริการ

  2. มอบบทบาท IAM ผู้ใช้บริการ (roles/serviceusage.serviceUsageConsumer) ให้กับบัญชีบริการ ซึ่งรวมถึงสิทธิ์ serviceusage.services.use ที่อนุญาตให้บัญชีบริการส่งคำขอ API สำหรับโปรเจ็กต์ได้

    gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
  --role="roles/serviceusage.serviceUsageConsumer"

  3. ให้สิทธิ์บัญชี Google ของคุณมีบทบาท IAM ผู้สร้างโทเค็นบัญชีบริการ (roles/iam.serviceAccountTokenCreator) ในบัญชีบริการ

    gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
  --member="user:USER_EMAIL" \
  --role="roles/iam.serviceAccountTokenCreator"

  4. กำหนดค่า ADC โดยเรียกใช้คำสั่งต่อไปนี้

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"

    หากต้องการใช้ข้อมูลเข้าสู่ระบบเดียวกันสำหรับ Data Manager API และ Google Ads API ให้รวมขอบเขต Google Ads API ไว้ในรายการ --scopes ดังนี้

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"

    หากต้องการใช้ข้อมูลเข้าสู่ระบบเดียวกันสำหรับ Data Manager API และ Display & Video 360 API ให้รวมขอบเขต Display & Video 360 API ไว้ในรายการ --scopes ดังนี้

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"

    เมื่อได้รับข้อความแจ้งให้ลงชื่อเข้าใช้ ให้เข้าสู่ระบบด้วยบัญชี Google ที่มีบทบาทผู้สร้างโทเค็นบัญชีบริการ

  5. ยืนยันว่าตั้งค่าข้อมูลเข้าสู่ระบบอย่างถูกต้องโดยใช้คำสั่งต่อไปนี้ หากสำเร็จ คำสั่งจะพิมพ์โทเค็นเพื่อการเข้าถึงไปยังคอนโซล

    gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"

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

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

บัญชีผู้ใช้

เลือกแท็บที่ตรงกับ Use Case ของคุณ

  • เลือกผู้ลงโฆษณาหากคุณใช้ข้อมูลเข้าสู่ระบบของบัญชี Google ที่เป็นผู้ใช้ในบัญชีผู้ลงโฆษณาที่ต้องการจัดการ
  • เลือกพาร์ทเนอร์ด้านข้อมูลหากคุณใช้ข้อมูลเข้าสู่ระบบของบัญชี Google ที่เป็นผู้ใช้ในบัญชีพาร์ทเนอร์ด้านข้อมูล และต้องการจัดการบัญชีผู้ลงโฆษณาที่มีลิงก์พาร์ทเนอร์ไปยังบัญชีพาร์ทเนอร์ด้านข้อมูล ระบบจะออกบัญชีพาร์ทเนอร์ด้านข้อมูลหลังจากผ่านกระบวนการอนุมัติแล้วเท่านั้น หากต้องการเริ่มต้นใช้งาน ให้กรอกข้อมูลในแบบฟอร์มแสดงความสนใจ

ผู้ลงโฆษณา

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

ทำตามวิธีการเพื่อเพิ่มอีเมลของผู้ใช้ลงในบัญชี Google Ads หรือบัญชีดูแลจัดการ Google Ads หลัก

Display & Video 360

ทำตามวิธีการเพื่อเพิ่มอีเมลของผู้ใช้ลงในบัญชี

Google Analytics

ทำตามวิธีการเพื่อเพิ่มอีเมลของผู้ใช้ลงในบัญชี

พาร์ทเนอร์ด้านข้อมูล

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

เพิ่มอีเมลของผู้ใช้ลงในบัญชีพาร์ทเนอร์ด้านข้อมูลผ่าน UI ของ Google Ads โดยทำตามวิธีการเหล่านี้

บัญชีบริการ

เลือกแท็บที่ตรงกับ Use Case ของคุณ

  • เลือกผู้ลงโฆษณาหากคุณใช้ข้อมูลเข้าสู่ระบบของบัญชี Google ที่เป็นผู้ใช้ในบัญชีผู้ลงโฆษณาที่ต้องการจัดการ
  • เลือกพาร์ทเนอร์ด้านข้อมูลหากคุณใช้ข้อมูลเข้าสู่ระบบของบัญชี Google ที่เป็นผู้ใช้ในบัญชีพาร์ทเนอร์ด้านข้อมูล และต้องการจัดการบัญชีผู้ลงโฆษณาที่มีลิงก์พาร์ทเนอร์ไปยังบัญชีพาร์ทเนอร์ด้านข้อมูล ระบบจะออกบัญชีพาร์ทเนอร์ด้านข้อมูลหลังจากผ่านกระบวนการอนุมัติแล้วเท่านั้น หากต้องการเริ่มต้นใช้งาน ให้กรอกข้อมูลในแบบฟอร์มแสดงความสนใจ

ผู้ลงโฆษณา

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

ทำการตั้งค่าสิทธิ์เข้าถึงบัญชีให้เสร็จสมบูรณ์เพื่อเพิ่มบัญชีบริการลงในบัญชี Google Ads หรือบัญชีดูแลจัดการ Google Ads หลัก

Display & Video 360

ทำตามวิธีการเพื่อสร้างผู้ใช้ Display & Video 360 ที่เชื่อมโยงกับบัญชีบริการ

Google Analytics

ทำตามวิธีการเพื่อเพิ่มอีเมลของบัญชีบริการลงในบัญชี

พาร์ทเนอร์ด้านข้อมูล

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

สิทธิ์เข้าถึงบัญชีพาร์ทเนอร์ด้านข้อมูลจะจัดการผ่าน UI ของ Google Ads หากต้องการเพิ่มบัญชีบริการและตั้งค่าระดับการเข้าถึง ให้ทำตามขั้นตอนในการตั้งค่าการเข้าถึงบัญชี

ขั้นตอนถัดไป

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