Authentication

คำขอไปยัง ReachPlanService ต้อง ระบุโทเค็นนักพัฒนาซอฟต์แวร์ที่ได้รับอนุมัติ ข้อมูลเข้าสู่ระบบ OAuth และรหัสลูกค้าที่ ข้อมูลเข้าสู่ระบบ OAuth ของคุณเข้าถึงได้

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

โทเค็นนักพัฒนาซอฟต์แวร์และข้อมูลเข้าสู่ระบบ OAuth

นอกเหนือจากคำแนะนำที่ระบุไว้ในเริ่มต้นใช้งานแล้ว โปรดคำนึงถึงประเด็นต่อไปนี้

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

รหัสลูกค้า

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

เครื่องมือภายใน

หากคุณสร้างเครื่องมือเพื่อใช้ภายในองค์กร เราขอแนะนำให้คุณทำดังนี้

นักวางแผนที่ไม่มีสิทธิ์เข้าถึงบัญชีลูกค้าโดยตรง

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

นักวางแผนที่มีสิทธิ์เข้าถึงบัญชีลูกค้า

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

เครื่องมือภายนอก

หากคุณสร้างเครื่องมือสำหรับผู้ใช้ภายนอก เราขอแนะนำให้ใช้วิธีการที่คล้ายกันดังนี้

บัญชีต่อลูกค้า

สร้างข้อมูลเข้าสู่ระบบ OAuth โดยใช้โฟลว์ของแอปพลิเคชันที่ติดตั้งสำหรับผู้ใช้ ที่มีสิทธิ์เข้าถึงบัญชีดูแลจัดการของโทเค็นนักพัฒนาแอป สร้างบัญชี Google Ads ต่อลูกค้าภายนอก 1 ราย และลิงก์บัญชีเหล่านั้นกับบัญชีดูแลจัดการ จากนั้นกำหนดค่าเครื่องมือเพื่อให้รหัสลูกค้าที่เกี่ยวข้องของลูกค้า เมื่อลูกค้าสร้างแผน

สิทธิ์เข้าถึงที่ผู้ใช้ให้

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

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

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

ดูวิธีระบุแผนสื่อ