การตรวจสอบแอป OAuth

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

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

ระยะของกลุ่มเป้าหมายของแอป

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

ระยะที่ 1: การพัฒนาช่วงริเริ่ม (การทดสอบ)

เมื่อเริ่มพัฒนาและทดสอบคำขอ API พื้นฐาน ให้ทำดังนี้

• สถานะการเผยแพร่: ตั้งค่าเป็นการทดสอบ

• ประเภทผู้ใช้:

  หากโปรเจ็กต์ที่อยู่ในระบบคลาวด์ Google เป็นขององค์กร Google Workspace และมีเพียงผู้ใช้ในองค์กรเท่านั้นที่ใช้แอป ให้เลือกภายใน

  หรือเลือกภายนอก

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

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

ระยะที่ 2: ใกล้เปิดตัว (การส่งเพื่อขอรับการยืนยัน)

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

1. อัปเดตการตั้งค่าหน้ากลุ่มเป้าหมาย ดังนี้

   • สถานะการเผยแพร่: เปลี่ยนเป็นเวอร์ชันที่ใช้งานจริง

   • ประเภทผู้ใช้: ตั้งค่าเป็นภายนอกหากแอปให้บริการลูกค้าภายนอกองค์กร เช่น ลูกค้าผู้ลงโฆษณา

2. ส่งแอปเพื่อรับการยืนยัน กระบวนการยืนยันแอป Google OAuth อาจใช้เวลาหลายสัปดาห์ ดังนั้นโปรดส่งโดยเร็วที่สุดเมื่อ UI ของคุณพร้อมแล้ว

ข้อกำหนดในการตรวจสอบแอป

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

การสร้างแบรนด์และนโยบายความเป็นส่วนตัว

ในหน้าการสร้างแบรนด์ในคอนโซล Google Cloud ให้ยืนยันรายละเอียดต่อไปนี้ก่อนส่ง

• หน้าแรกของแอปพลิเคชัน: หน้าแรกต้องเข้าถึงได้แบบสาธารณะและมีลิงก์ที่มองเห็นได้ไปยังนโยบายความเป็นส่วนตัวของแอปพลิเคชัน

• ลิงก์นโยบายความเป็นส่วนตัว: URL นโยบายความเป็นส่วนตัวที่กำหนดค่าไว้ในหน้าการสร้างแบรนด์ต้องตรงกับ URL นโยบายความเป็นส่วนตัวที่ลิงก์ไว้ในหน้าแรกของแอปพลิเคชัน

ขอบเขตการยืนยัน

ในหน้าการเข้าถึงข้อมูล ให้ขอเฉพาะขอบเขตที่แอปพลิเคชันของคุณต้องการ Data Manager API ใช้ขอบเขตที่ละเอียดอ่อนดังนี้

• https://www.googleapis.com/auth/datamanager (ขอบเขตหลัก)

• https://www.googleapis.com/auth/datamanager.partnerlink (สำหรับลิงก์พาร์ทเนอร์)

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

ข้อมูลติดต่อ

ทีมตรวจสอบ OAuth ของ Google จะส่งการสื่อสารทั้งหมดไปยังเจ้าของโปรเจ็กต์และผู้แก้ไขโปรเจ็กต์ที่กำหนดค่าไว้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google อัปเดตข้อมูลติดต่อเหล่านี้ในคอนโซล Google Cloud อยู่เสมอเพื่อไม่ให้พลาดคำขอข้อมูล

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

วิดีโอการสาธิต

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

ตรวจสอบว่าวิดีโอเป็นไปตามข้อกำหนดของวิดีโอสาธิตฟังก์ชันการทำงานของแอปทั้งหมด รวมถึงการตรวจสอบ Data Manager API ต่อไปนี้

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

• ข้อมูลประจำตัวของแอปที่ตรงกัน: ตรวจสอบว่าชื่อแอปพลิเคชัน โลโก้ และการสร้างแบรนด์ที่แสดงในวิดีโอตรงกับการกำหนดค่าหน้าการสร้างแบรนด์ในคอนโซล Google Cloud

• หน้าจอขอความยินยอม OAuth ที่สมบูรณ์เป็นภาษาอังกฤษ: แสดงหน้าจอขอความยินยอม OAuth ทั้งหมดโดยตั้งค่าตัวเลือกภาษาที่มุมซ้ายล่างเป็นภาษาอังกฤษ และตรวจสอบว่าหน้าจอแสดงขอบเขต Data Manager API ที่แอปของคุณขออย่างถูกต้อง

• การใช้งานขอบเขตใน UI ของแอป: แสดงฟีเจอร์ของแอปที่ใช้ขอบเขตที่ขอ (เช่น การสร้างลิงก์พาร์ทเนอร์ การสร้างรายการกลุ่มเป้าหมาย หรือการกำหนดค่าการนำเข้าข้อมูลใน UI ของแอปพลิเคชัน)

ระยะที่ 3: พร้อมเปิดตัว (ยืนยันแล้ว)

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