เมื่อทำงานกับ Google Ads API ระบบจะใช้อีเมลในหลายๆ ที่เพื่อการติดต่อและการจัดการ Access Management โดยหลักเกณฑ์ที่สำคัญที่สุดมีดังนี้
- อีเมลติดต่อของ Google Ads API: อีเมลที่ได้รับมอบหมายบทบาทเจ้าของหรือผู้แก้ไขในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ซึ่ง Google ใช้เพื่อส่งประกาศการให้บริการที่คุณจำเป็นต้องได้รับ (MSA) และการแจ้งเตือนด้านการดูแลระบบ
- อีเมลของบัญชีคอนโซล Google Cloud: อีเมลที่มีสิทธิ์เข้าถึงระดับผู้ดูแลระบบในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ Google Cloud ที่ใช้สำหรับแอปพลิเคชัน OAuth 2.0
- สิทธิ์เข้าถึงบัญชีดูแลจัดการ Google Ads: บัญชีบริการ (แนะนำ) หรืออีเมลแทนที่ใช้ร่วมกันซึ่งมีสิทธิ์เข้าถึงบัญชีดูแลจัดการ Google Ads ที่เข้าถึงผ่าน Google Ads API
ส่วนที่เหลือของคู่มือนี้จะอธิบายรายละเอียดเกี่ยวกับบัญชีแต่ละประเภทที่ระบุไว้ก่อนหน้านี้ และวิธีที่คุณสามารถกำหนดค่าบัญชีเหล่านั้นเพื่อให้การผสานรวมของคุณไม่ต้องขึ้นอยู่กับอีเมลของผู้ใช้แต่ละราย
อีเมลติดต่อ Google Ads API
Google จะส่งการแจ้งเตือนด้านการดูแลระบบ ข้อมูลอัปเดตเกี่ยวกับการตรวจสอบ API คำขอตรวจสอบ ประกาศการให้บริการที่คุณจำเป็นต้องได้รับ (MSA) และการสื่อสารในกรณีฉุกเฉินเกี่ยวกับการใช้งานจริงไปยังอีเมลที่เชื่อมโยงกับบทบาทเจ้าของและผู้แก้ไขของโปรเจ็กต์ Google Cloud (ดูอีเมลติดต่อใหม่ของ API เนื่องจากเราได้เลิกใช้การตั้งค่าอีเมลติดต่อเดิมของศูนย์ API ใน UI ของ Google Ads แล้ว)
หากต้องการอัปเดตอีเมลติดต่อและตรวจสอบว่าทั้งทีมได้รับการแจ้งเตือนเหล่านี้ ให้มอบบทบาทเจ้าของหรือผู้แก้ไขให้กับอีเมลแทนของทีมที่แชร์ในโปรเจ็กต์ Google Cloud และตรวจสอบอีเมลที่ส่งไปยังอีเมลแทนนั้นเป็นประจำ
บัญชีคอนโซล Google Cloud
โปรเจ็กต์คอนโซล Google Cloud มีข้อมูลเข้าสู่ระบบ OAuth ของแอปพลิเคชันและควบคุมการเข้าถึง Google Ads API ตรวจสอบสิทธิ์เข้าถึงโปรเจ็กต์นี้โดยให้สิทธิ์บทบาทเจ้าของ (หรือผู้แก้ไข) แก่นามแฝงของทีมที่แชร์
ทำตามขั้นตอนต่อไปนี้เพื่อเพิ่มอีเมลแทนที่ใช้ร่วมกันเป็นเจ้าของโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google
- ลงชื่อเข้าใช้คอนโซล Google Cloud
- เลือกโปรเจ็กต์จากตัวเลือกโปรเจ็กต์ที่ด้านบนของหน้า
- ในเมนูการนำทาง ให้ไปที่ IAM และผู้ดูแลระบบ > IAM
- คลิกให้สิทธิ์เข้าถึง
- ในส่วนเพิ่มผู้ใช้หลัก ให้ป้อนอีเมลที่แชร์ในช่องผู้ใช้หลักใหม่
- ในส่วนกำหนดบทบาท ให้คลิกเลือกบทบาท แล้วเลือกพื้นฐาน > เจ้าของ (หรือพื้นฐาน > ผู้แก้ไข)
- คลิกบันทึก หากคุณให้สิทธิ์บทบาทเจ้าของแก่อีเมลภายนอกองค์กร Google Cloud (หรือในโปรเจ็กต์ที่ไม่มีองค์กร) Google Cloud จะส่งอีเมลคำเชิญไปยังอีเมลแทนที่แชร์ซึ่งต้องได้รับการยอมรับก่อนที่บทบาทจะมีผล ดูข้อมูลเพิ่มเติมเกี่ยวกับการให้และเพิกถอนสิทธิ์เข้าถึงได้ในเอกสารประกอบของ Cloud
บัญชีดูแลจัดการ Google Ads
วิธีทั่วไปในการจัดการบัญชีโดยใช้ Google Ads API คือการลิงก์บัญชีทั้งหมดไว้ในบัญชีดูแลจัดการทั่วไป และเรียกใช้ API ไปยังบัญชีทั้งหมดโดยใช้ข้อมูลเข้าสู่ระบบของบัญชีดูแลจัดการระดับบนสุด ในการกำหนดค่านี้ นักพัฒนาซอฟต์แวร์จะตั้งค่าส่วนหัวของคำขอ login-customer-id (หรือการตั้งค่าการกำหนดค่าไลบรารีของไคลเอ็นต์ login_customer_id) เป็นรหัสลูกค้า 10 หลัก (ไม่มีขีดกลาง) ของบัญชีดูแลจัดการ Google Ads และตั้งค่าเป้าหมาย customer_id เป็นบัญชีที่ใช้ดำเนินการซึ่งมีการเรียก API
แนะนำ: ใช้บัญชีบริการ
การใช้บัญชีบริการเป็นวิธีที่แนะนำสำหรับการตรวจสอบสิทธิ์และการเข้าถึงบัญชีดูแลจัดการ Google Ads บัญชีบริการจะได้รับการจัดการภายในโปรเจ็กต์ Google Cloud และไม่ได้เชื่อมโยงกับบุคคลใดบุคคลหนึ่ง ซึ่งแตกต่างจากบัญชีผู้ใช้แต่ละราย จึงช่วยป้องกันไม่ให้เกิดการหยุดทำงานเมื่อสมาชิกในทีมเปลี่ยนบทบาทหรือลาออกจากบริษัท ทำตามคู่มือบัญชีบริการเพื่อสร้างบัญชีบริการและให้สิทธิ์เข้าถึงบัญชีดูแลจัดการ Google Ads
ทางเลือก: ใช้อีเมลแทนที่ใช้ร่วมกัน
หากการผสานรวมใช้บัญชีบริการไม่ได้และต้องอาศัยเวิร์กโฟลว์การตรวจสอบสิทธิ์ผู้ใช้คนเดียวแทน ผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชีดูแลจัดการ Google Ads จะเป็นผู้ออกโทเค็นการรีเฟรช OAuth 2.0
วิธีหลีกเลี่ยงสถานการณ์นี้เมื่อใช้ข้อมูลเข้าสู่ระบบของผู้ใช้มีดังนี้
- เชิญอีเมลแทนที่แชร์ (ซึ่งได้รับการสนับสนุนโดยบัญชี Google ที่ใช้งานอยู่และเปิดใช้การยืนยันด้วยพาสคีย์) ให้จัดการบัญชีดูแลจัดการ Google Ads นี้ด้วยระดับการเข้าถึงที่เหมาะสม
- ยอมรับคำเชิญโดยใช้อีเมลแทนที่แชร์
- ใช้อีเมลแทนที่ใช้ร่วมกันนี้เพื่อออกโทเค็นการรีเฟรช OAuth สำหรับการเรียก API