แอปทั้งหมดที่เข้าถึง Google APIs ต้องยืนยันว่าแอปแสดงตัวตนและเจตนาอย่างถูกต้องตามที่ระบุไว้ในนโยบายข้อมูลผู้ใช้บริการ API ของ Google หน้าจอขอความยินยอมและแอปพลิเคชันของคุณอาจต้องได้รับการยืนยันจาก Google เพื่อปกป้องคุณและผู้ใช้ที่แชร์ของ Google และแอปของคุณ
แอปของคุณต้องได้รับการยืนยันหากเป็นไปตามเกณฑ์ทั้งหมดต่อไปนี้
- ในคอนโซล Google API การกำหนดค่าแอปของคุณจะตั้งค่าไว้สำหรับประเภทผู้ใช้เป็นภายนอก และสถานะการเผยแพร่เป็นเผยแพร่แล้ว ซึ่งหมายความว่าแอปของคุณอยู่ในเวอร์ชันที่ใช้งานจริงและพร้อมให้บริการแก่ผู้ใช้ทุกคนที่มีบัญชี Google
- คุณต้องการให้แอปแสดงโลโก้หรือชื่อที่แสดงในหน้าจอขอความยินยอมของ OAuth
หากคุณยืนยันข้อมูลแบรนด์ของแอป คุณจะเพิ่มโอกาสที่ผู้ใช้จะจดจำแบรนด์ของคุณและตัดสินใจให้สิทธิ์เข้าถึงแอปได้ ข้อมูลแบรนด์ที่ยืนยันแล้วยังช่วยลดการเพิกถอนสิทธิ์ในภายหลังเมื่อผู้ใช้หรือผู้ดูแลระบบ Google Workspace ตรวจสอบแอปและบริการของบุคคลที่สามที่มีสิทธิ์เข้าถึงบัญชี โดยปกติแล้ว กระบวนการยืนยันแบรนด์อัตโนมัติจะใช้เวลาไม่กี่นาทีหลังจากที่คุณคลิกปุ่มยืนยันการสร้างแบรนด์ ในบางกรณีที่ระบบไม่สามารถระบุผลลัพธ์โดยอัตโนมัติ แอปของคุณอาจต้องผ่านกระบวนการตรวจสอบโดยเจ้าหน้าที่ ซึ่งโดยปกติจะใช้เวลา 2-3 วันทำการ
หากข้อมูลการสร้างแบรนด์ของแอปยังไม่ได้รับการยืนยัน อาจส่งผลให้ผู้ใช้ไว้วางใจคำขอข้อมูลของคุณน้อยลง ซึ่งอาจทำให้มีการให้สิทธิ์จากผู้ใช้น้อยลงและมีการเพิกถอนมากขึ้นในภายหลัง
หน้าจอคำยินยอม OAuth
หน้าจอขอความยินยอมจะแจ้งให้ผู้ใช้ทราบว่าใครเป็นผู้ขอสิทธิ์เข้าถึงข้อมูล และแอปของคุณต้องการเข้าถึงข้อมูลประเภทใดในนามของผู้ใช้ ดังที่ไฮไลต์ไว้ในช่องที่ 2 ของรูปที่ 1
เมื่อแอปผ่านกระบวนการยืนยันแบรนด์และได้รับอนุมัติ บัญชีที่ให้สิทธิ์มีแนวโน้มที่จะเข้าใจข้อมูลประจำตัวและนโยบายข้อมูลผู้ใช้ของแอปพลิเคชันได้ชัดเจนยิ่งขึ้น ความเข้าใจที่ชัดเจนนี้จะเพิ่มโอกาสที่เจ้าของบัญชีจะให้สิทธิ์ตามคำขอของคุณและคงสิทธิ์เข้าถึงไว้เมื่อตรวจสอบการเพิกถอนที่เป็นไปได้ในหน้าบัญชี Google เนื้อหาที่คุณกำหนดค่าในหน้าการสร้างแบรนด์ OAuth ใน Cloud Console จะสร้างคอมโพเนนต์ต่อไปนี้
- ชื่อและโลโก้แอป (ตามที่แสดงในช่อง 1 ของรูปที่ 1)
- อีเมลสนับสนุนผู้ใช้ ซึ่งจะปรากฏหลังจากเลือกชื่อแอป (ช่อง 2 ของรูปที่ 1)
- ลิงก์ไปยังนโยบายความเป็นส่วนตัวและข้อกำหนดในการให้บริการ (ช่อง 3 ของรูปที่ 1)
โดเมนที่ได้รับอนุญาต
ในกระบวนการยืนยันแบรนด์ Google กำหนดให้ต้องยืนยันโดเมนทั้งหมดที่เชื่อมโยงกับหน้าจอขอความยินยอม OAuth และข้อมูลเข้าสู่ระบบของแอปพลิเคชัน เราขอให้คุณยืนยันคอมโพเนนต์โดเมนที่พร้อมให้จดทะเบียนในคำต่อท้ายสาธารณะ ซึ่งก็คือ "โดเมนส่วนตัวระดับบนสุด" ตัวอย่างเช่น หน้าจอขอความยินยอม OAuth ที่กำหนดค่าด้วยหน้าแรกของแอปพลิเคชันเป็น https://sub.example.com/product จะขอให้เจ้าของบัญชียืนยันการเป็นเจ้าของโดเมน example.com
ส่วนโดเมนที่ได้รับอนุญาตของเครื่องมือแก้ไขหน้าจอขอความยินยอม OAuth ต้องมีโดเมนส่วนตัวระดับบนสุดที่ใช้ใน URI ของส่วนโดเมนแอป โดเมนเหล่านี้รวมถึงหน้าแรกของแอป นโยบายความเป็นส่วนตัว และข้อกำหนดในการให้บริการ ส่วนโดเมนที่ได้รับอนุญาตยังต้องมี URI การเปลี่ยนเส้นทางหรือต้นทางของ JavaScript ที่ได้รับอนุญาตในประเภทไคลเอ็นต์ OAuth "เว็บแอปพลิเคชัน" ด้วย
ยืนยันการเป็นเจ้าของโดเมนที่ได้รับอนุญาตโดยใช้ Google Search Console บัญชี Google ที่มีสิทธิ์ของเจ้าของสำหรับโดเมนต้องเชื่อมโยงกับโปรเจ็กต์คอนโซล API ที่ใช้โดเมนที่ได้รับอนุญาตนั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับการยืนยันโดเมนใน Google Search Console ได้ที่หัวข้อยืนยันการเป็นเจ้าของเว็บไซต์
ขั้นตอนการเตรียมพร้อมสำหรับการยืนยัน
แอปทั้งหมดที่ใช้ Google APIs เพื่อขอสิทธิ์เข้าถึงข้อมูลต้องทำตามขั้นตอนต่อไปนี้เพื่อยืนยันแบรนด์ให้เสร็จสมบูรณ์
- ยืนยันว่าแอปของคุณไม่อยู่ในกรณีการใช้งานใดๆ ในส่วนข้อยกเว้นสำหรับข้อกำหนดในการยืนยัน
- ตรวจสอบว่าแอปเป็นไปตามข้อกำหนดแบรนด์ของ API หรือผลิตภัณฑ์ที่เกี่ยวข้อง ตัวอย่างเช่น ดูหลักเกณฑ์การใช้แบรนด์สำหรับขอบเขต Google Sign-In
- ยืนยันการเป็นเจ้าของโดเมนที่ได้รับอนุญาตของโปรเจ็กต์ภายใน Google Search Console ใช้บัญชี Google ที่เชื่อมโยงกับโปรเจ็กต์คอนโซล API ในฐานะเจ้าของหรือผู้แก้ไข
- ตรวจสอบว่าข้อมูลการสร้างแบรนด์ทั้งหมดในหน้าจอขอความยินยอม OAuth เช่น ชื่อแอป อีเมลสนับสนุน URI ของหน้าแรก URI ของนโยบายความเป็นส่วนตัว ฯลฯ แสดงข้อมูลประจำตัวของแอปอย่างถูกต้อง
ข้อกำหนดของหน้าแรกของแอปพลิเคชัน
ตรวจสอบว่าหน้าแรกเป็นไปตามข้อกำหนดต่อไปนี้
- หน้าแรกต้องเข้าถึงได้แบบสาธารณะ ไม่ใช่แค่เข้าถึงได้สำหรับผู้ใช้ที่เข้าสู่ระบบของเว็บไซต์เท่านั้น
- ความเกี่ยวข้องของหน้าแรกกับแอปที่อยู่ระหว่างการตรวจสอบต้องชัดเจน
- ลิงก์ไปยังข้อมูลของแอปใน Google Play Store หรือหน้า Facebook ของแอปไม่ถือว่าเป็นหน้าแรกของแอปพลิเคชันที่ถูกต้อง
ข้อกำหนดเกี่ยวกับลิงก์นโยบายความเป็นส่วนตัวของแอปพลิเคชัน
ตรวจสอบว่านโยบายความเป็นส่วนตัวของแอปเป็นไปตามข้อกำหนดต่อไปนี้
- นโยบายความเป็นส่วนตัวต้องแสดงให้ผู้ใช้เห็น โดยโฮสต์ภายในโดเมนเดียวกับหน้าแรกของแอปพลิเคชัน และลิงก์กับหน้าจอขอความยินยอม OAuth ของคอนโซล Google API โปรดทราบว่าหน้าแรกต้องมีคำอธิบายฟังก์ชันการทำงานของแอป รวมถึงลิงก์ไปยังนโยบายความเป็นส่วนตัวและข้อกำหนดในการให้บริการ (ไม่บังคับ)
- นโยบายความเป็นส่วนตัวต้องเปิดเผยลักษณะที่แอปพลิเคชันของคุณเข้าถึง ใช้ จัดเก็บ หรือแชร์ข้อมูลผู้ใช้ Google คุณต้องจำกัดการใช้ข้อมูลผู้ใช้ Google ให้เป็นไปตามแนวทางปฏิบัติที่นโยบายความเป็นส่วนตัวที่เผยแพร่ของคุณเปิดเผยไว้
วิธีส่งแอปเพื่อรับการยืนยันแบรนด์
โปรเจ็กต์คอนโซล Google Cloud จะจัดระเบียบทรัพยากรทั้งหมดในคอนโซล Cloud โปรเจ็กต์ประกอบด้วยชุดบัญชี Google ที่เชื่อมโยงซึ่งมีสิทธิ์ดำเนินการโปรเจ็กต์, ชุด API ที่เปิดใช้ และการตั้งค่าการเรียกเก็บเงิน การตรวจสอบสิทธิ์ และการตรวจสอบสำหรับ API เหล่านั้น เช่น โปรเจ็กต์อาจมีไคลเอ็นต์ OAuth อย่างน้อย 1 รายการ กำหนดค่า API เพื่อให้ไคลเอ็นต์เหล่านั้นใช้งาน และกำหนดค่าหน้าจอขอความยินยอม OAuth ที่แสดงต่อผู้ใช้ก่อนที่จะให้สิทธิ์เข้าถึงแอปของคุณ
หากไคลเอ็นต์ OAuth ใดของคุณยังไม่พร้อมใช้งานจริง เราขอแนะนำให้ลบไคลเอ็นต์ดังกล่าวออกจากโปรเจ็กต์ที่ขอรับการยืนยัน ซึ่งทำได้ในหน้าลูกค้า
หากต้องการส่งเพื่อรับการยืนยัน ให้ทำตามขั้นตอนต่อไปนี้
- ตรวจสอบว่าแอปเป็นไปตามข้อกำหนดในการให้บริการของ Google APIs และนโยบายข้อมูลผู้ใช้สำหรับบริการ Google API
- อัปเดตบทบาทเจ้าของและผู้แก้ไขของบัญชีที่เชื่อมโยงกับโปรเจ็กต์ให้เป็นปัจจุบัน รวมถึงอีเมลสนับสนุนผู้ใช้และข้อมูลติดต่อของนักพัฒนาแอปในหน้าจอขอความยินยอม OAuth ใน Cloud Console วิธีนี้จะช่วยให้มั่นใจได้ว่าสมาชิกที่เหมาะสมในทีมจะได้รับแจ้งเกี่ยวกับข้อกำหนดใหม่ๆ
- ไปที่หน้าการสร้างแบรนด์ OAuth ของ Cloud Console
- คลิกปุ่มตัวเลือกโปรเจ็กต์
- ในกล่องโต้ตอบเลือกจากที่ปรากฏขึ้น ให้เลือกโปรเจ็กต์ หากไม่พบโปรเจ็กต์แต่ทราบรหัสโปรเจ็กต์ คุณสามารถสร้าง URL ในเบราว์เซอร์ในรูปแบบต่อไปนี้
https://console.developers.google.com/auth/branding?project=[PROJECT_ID]
- ในหน้าการสร้างแบรนด์ ให้ระบุข้อมูลการสร้างแบรนด์ของแอป ซึ่งรวมถึงชื่อแอป โลโก้ ข้อมูลติดต่อนักพัฒนาแอป และลิงก์ที่เกี่ยวข้อง ระบบจะบันทึกการเปลี่ยนแปลงที่คุณทำเป็นการสร้างแบรนด์ฉบับร่าง
- คลิกปุ่มยืนยันการสร้างแบรนด์เพื่อเริ่มกระบวนการประเมิน โดยปกติแล้ว การตรวจสอบแบบอัตโนมัติจะเสร็จสิ้นภายในไม่กี่นาที
- เมื่อการประเมินเสร็จสมบูรณ์แล้ว ให้ตรวจสอบสถานะ หากสำเร็จ สถานะจะเปลี่ยนเป็นพร้อมเผยแพร่ หากการยืนยันอัตโนมัติไม่สำเร็จ คุณจะเห็นปัญหาที่ตรวจพบและแก้ไขปัญหาหรือขอรับการตรวจสอบโดยเจ้าหน้าที่ได้
- คลิกปุ่มเผยแพร่การสร้างแบรนด์เพื่อเผยแพร่การสร้างแบรนด์ใหม่
- หากแอปของคุณต้องมีการยืนยันสำหรับขอบเขตที่ละเอียดอ่อนหรือถูกจำกัดด้วย ให้ไปที่ศูนย์การยืนยัน OAuth เพื่อติดตามสถานะการเข้าถึงข้อมูลและระบุข้อมูลเพิ่มเติมที่ขอ เช่น วิดีโอสาธิต โปรดทราบว่าคุณต้องมีสถานะการสร้างแบรนด์ที่เผยแพร่แล้วก่อนจึงจะขอรับการยืนยันเพื่อเข้าถึงข้อมูลได้
- ใช้ปุ่มเพิ่มหรือนำขอบเขตออกเพื่อประกาศขอบเขตทั้งหมดที่แอปขอ ชุดขอบเขตเริ่มต้นที่จำเป็นสำหรับ Google Sign-In จะกรอกข้อมูลล่วงหน้าไว้ในส่วนขอบเขตที่ไม่ละเอียดอ่อน ขอบเขตที่เพิ่มจะจัดประเภทเป็นไม่ละเอียดอ่อน ละเอียดอ่อน หรือถูกจำกัด
- ระบุลิงก์สูงสุด 3 รายการไปยังเอกสารประกอบที่เกี่ยวข้องสำหรับฟีเจอร์ที่เกี่ยวข้องในแอปของคุณ
- ระบุข้อมูลเพิ่มเติมที่ระบบขอเกี่ยวกับแอปของคุณในขั้นตอนต่อๆ ไป
หลังจากที่คุณเผยแพร่การสร้างแบรนด์หรือส่งคำขอเข้าถึงข้อมูลแล้ว ทีมความน่าเชื่อถือและความปลอดภัยของ Google อาจติดตามผลทางอีเมลพร้อมข้อมูลเพิ่มเติมที่ต้องการหรือขั้นตอนที่คุณต้องดำเนินการให้เสร็จสมบูรณ์ ตรวจสอบอีเมลในส่วนข้อมูลติดต่อของนักพัฒนาแอปและอีเมลสนับสนุนของหน้าจอขอความยินยอม OAuth เพื่อดูคำขอข้อมูลเพิ่มเติม นอกจากนี้ คุณยังดูหน้าการสร้างแบรนด์หรือศูนย์การยืนยันของโปรเจ็กต์เพื่อยืนยันสถานะการตรวจสอบปัจจุบันของโปรเจ็กต์ได้ รวมถึงดูว่ากระบวนการตรวจสอบหยุดชั่วคราวขณะที่เรารอการตอบกลับจากคุณหรือไม่
ข้อยกเว้นสำหรับข้อกำหนดในการยืนยัน
หากจะใช้แอปในสถานการณ์ใดๆ ที่อธิบายไว้ในส่วนต่อไปนี้ คุณไม่จำเป็นต้องส่งแอปเพื่อรับการตรวจสอบ
การใช้งานส่วนตัว
กรณีการใช้งานหนึ่งคือหากคุณเป็นผู้ใช้แอปเพียงคนเดียว หรือหากแอปของคุณมีผู้ใช้เพียงไม่กี่คน ซึ่งทุกคนเป็นคนที่คุณรู้จักเป็นการส่วนตัว คุณและผู้ใช้จำนวนจำกัดอาจดำเนินการต่อผ่านหน้าจอแอปที่ไม่ได้รับการยืนยันและให้สิทธิ์บัญชีส่วนตัวเข้าถึงแอปของคุณได้
โปรเจ็กต์ที่ใช้ในระดับการพัฒนา การทดสอบ หรือการทดลองใช้จริง
เพื่อให้เป็นไปตามนโยบาย Google OAuth 2.0 เราขอแนะนำให้คุณมีโปรเจ็กต์ที่แตกต่างกันสำหรับสภาพแวดล้อมการทดสอบและสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์ เราขอแนะนำให้ส่งแอปเพื่อรับการยืนยันเฉพาะในกรณีที่คุณต้องการให้แอปพร้อมใช้งานสำหรับผู้ใช้ที่มีบัญชี Google ดังนั้น หากแอปอยู่ในขั้นตอนการพัฒนา การทดสอบ หรือการทดลองใช้ คุณก็ไม่จำเป็นต้องทำการยืนยัน
หากแอปอยู่ในระยะการพัฒนาหรือการทดสอบ คุณสามารถปล่อยสถานะการเผยแพร่ไว้ในการตั้งค่าเริ่มต้นเป็นการทดสอบได้ การตั้งค่านี้หมายความว่าแอปของคุณยังอยู่ระหว่างการพัฒนาและพร้อมให้บริการแก่ผู้ใช้ที่คุณเพิ่มลงในรายชื่อผู้ใช้ทดสอบเท่านั้น คุณต้องจัดการรายชื่อบัญชี Google ที่เกี่ยวข้องกับการพัฒนาหรือการทดสอบแอป
ข้อมูลที่บริการเป็นเจ้าของเท่านั้น
หากแอปใช้บัญชีบริการเพื่อเข้าถึงเฉพาะข้อมูลของแอปเอง และไม่ได้เข้าถึงข้อมูลผู้ใช้ (ที่ลิงก์กับบัญชี Google) คุณก็ไม่จำเป็นต้องส่งเพื่อรับการยืนยัน
หากต้องการทำความเข้าใจว่าบัญชีบริการคืออะไร โปรดดูหัวข้อบัญชีบริการในเอกสารประกอบของ Google Cloud ดูวิธีการใช้บัญชีบริการได้ที่หัวข้อการใช้ OAuth 2.0 สำหรับแอปพลิเคชันแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์
ใช้ภายในเท่านั้น
ซึ่งหมายความว่าแอปนี้จะใช้ได้เฉพาะกับผู้ใช้ในองค์กร Google Workspace หรือ Cloud Identity ของคุณเท่านั้น องค์กรต้องเป็นเจ้าของโปรเจ็กต์ และต้องกำหนดค่าหน้าจอขอความยินยอม OAuth สำหรับประเภทผู้ใช้ภายใน ในกรณีนี้ แอปของคุณอาจต้องได้รับอนุมัติจากผู้ดูแลระบบองค์กร โปรดดูข้อมูลเพิ่มเติมที่หัวข้อข้อควรพิจารณาเพิ่มเติมสำหรับ Google Workspace
- ดูข้อมูลเพิ่มเติมเกี่ยวกับแอปพลิเคชันสาธารณะและแอปพลิเคชันภายใน
- ดูวิธีทำเครื่องหมายแอปเป็นแอปภายในได้ในคำถามที่พบบ่อยหัวข้อฉันจะทำเครื่องหมายแอปเป็นแอปภายในเท่านั้นได้อย่างไร
การติดตั้งทั่วทั้งโดเมน
หากคุณวางแผนให้แอปกำหนดเป้าหมายเฉพาะผู้ใช้ขององค์กร Google Workspace หรือ Cloud Identity และใช้การติดตั้งทั่วทั้งโดเมนเสมอ แอปของคุณก็ไม่จำเป็นต้องมีการยืนยันแบรนด์ อย่างไรก็ตาม หากแอปใช้ขอบเขตที่ถูกจำกัดหรือมีความละเอียดอ่อน คุณจะต้องการตรวจสอบแอป เนื่องจากการติดตั้งทั่วทั้งโดเมนช่วยให้ผู้ดูแลระบบโดเมนให้สิทธิ์แอปพลิเคชันบุคคลที่สามและแอปพลิเคชันภายในเข้าถึงข้อมูลของผู้ใช้ได้ ผู้ดูแลระบบองค์กรเป็นบัญชีเดียวที่สามารถเพิ่มแอปไปยังรายการที่อนุญาตเพื่อใช้ภายในโดเมนของตนได้
ดูวิธีทำให้แอปเป็นการติดตั้งทั่วทั้งโดเมนได้ในคำถามที่พบบ่อย แอปพลิเคชันของฉันมีผู้ใช้ที่มีบัญชีองค์กรจากโดเมน Google Workspace อื่น