ตั้งค่าการเข้าถึง 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 หรือทำตามวิธีการเพื่อดำเนินการขั้นตอนนี้ด้วยตนเอง

เคล็ดลับ: หากยังไม่มีโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google เปิดใช้ Data Manager API จะสร้างโปรเจ็กต์ให้คุณ

เปิดใช้ Data Manager API

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

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

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

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

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

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

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

บัญชีผู้ใช้

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

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

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

   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 ที่คุณใช้ สร้างข้อมูลเข้าสู่ระบบเป็น ผู้ใช้ทดสอบ

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

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

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

   หมายเหตุ: หากคุณเป็นพาร์ทเนอร์ด้านข้อมูลและต้องการไคลเอ็นต์ OAuth เพื่อรับข้อมูลเข้าสู่ระบบจากผู้ลงโฆษณาโดยเฉพาะ เพื่อสร้าง ลิงก์พาร์ทเนอร์ ให้เลือก เว็บเซิร์ฟเวอร์ หรือ เว็บ เบราว์เซอร์ เมื่อได้รับข้อความแจ้งให้ กำหนดค่าไคลเอ็นต์ 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"
   

   เคล็ดลับ: หากคุณเรียกใช้โค้ดในทรัพยากร Google Cloud (เช่น VM ของ Compute Engine, Cloud Run หรือ GKE) คุณจะข้ามขั้นตอนการนำข้อมูลมาใช้ที่เหลือได้ แต่ให้แนบบัญชีบริการกับ ทรัพยากรโดยตรง แล้วไปที่ ตั้งค่าสิทธิ์เข้าถึงบัญชี

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

   หมายเหตุ: คุณต้องทำตามขั้นตอนนี้แม้ว่าบัญชี Google ของคุณจะเป็นเจ้าของ โปรเจ็กต์ก็ตาม

   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"
   

หมายเหตุ: ขอบเขต https://www.googleapis.com/auth/datamanager เป็นขอบเขตหลักและใช้ได้กับบริการทั้งหมด ใน Data Manager API ขอบเขต https://www.googleapis.com/auth/datamanager.partnerlink ที่แคบกว่าจะใช้สำหรับ การจัดการลิงก์พาร์ทเนอร์เท่านั้น

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

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

บัญชีผู้ใช้

เลือกแท็บที่ตรงกับกรณีการใช้งานของคุณ

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

ผู้ลงโฆษณา

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

Google Ads

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

Display &Video 360

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

Google Analytics

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

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

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

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

บัญชีบริการ

เลือกแท็บที่ตรงกับกรณีการใช้งานของคุณ

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

ผู้ลงโฆษณา

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

Google Ads

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

Display &Video 360

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

Google Analytics

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

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

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

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

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

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