ลงทะเบียนชื่อแพ็กเกจด้วย Android Developer Console API

Android Developer Console API เป็นอินเทอร์เฟซสาธารณะที่ออกแบบมาเพื่อให้นักเผยแพร่แอปและนักพัฒนาแอปแต่ละรายลงทะเบียนชื่อแพ็กเกจใน Android Developer Console แบบเป็นโปรแกรมได้

ความสามารถแบบเซิร์ฟเวอร์กับเซิร์ฟเวอร์ของคุณในฐานะ

นักเผยแพร่แอป	นักพัฒนาแอปแต่ละราย
ลงทะเบียนชื่อแพ็กเกจ - คีย์ในนามของนักพัฒนาแอปที่เผยแพร่แอปใน Store ลงทะเบียนชื่อแพ็กเกจด้วยคีย์ที่ Store จัดการ พิสูจน์การเป็นเจ้าของคีย์ที่เชื่อมโยงกับชื่อแพ็กเกจ	ลงทะเบียนชื่อแพ็กเกจ - คีย์ในเวิร์กโฟลว์การติดตั้งใช้งานอย่างต่อเนื่อง พิสูจน์การเป็นเจ้าของคีย์ที่เชื่อมโยงกับชื่อแพ็กเกจ

ก่อนเริ่มต้น

ก่อนเริ่มต้น คุณควรมีสิ่งต่อไปนี้

1. สิทธิ์เข้าถึงระดับผู้ดูแลระบบในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google
2. ความเข้าใจพื้นฐานเกี่ยวกับสิ่งต่อไปนี้
   • RESTful API
   • โครงสร้าง APK
   • App Signing ของแอป Android
   • การสร้างไดเจสต์ SHA-256

นอกจากนี้ คุณควรคุ้นเคยกับคำศัพท์ต่อไปนี้ด้วย

คำศัพท์	คำจำกัดความ
บัญชีนักพัฒนาแอป	แสดงถึงบัญชี Android Developer Console ที่เป็นเจ้าของชื่อแพ็กเกจอย่างน้อย 1 รายการได้ ซึ่งมีสถานะการยืนยัน (NOT_VERIFIED หรือ VERIFIED)
ชื่อแพ็กเกจ	ชื่อแพ็กเกจ Android ที่เฉพาะเจาะจง (เช่น com.example.app) ภายในบัญชีนักพัฒนาแอป ซึ่งเชื่อมโยงกับคีย์อย่างน้อย 1 รายการได้ ซึ่งมีสถานะการลงทะเบียน (DRAFT, IN_REVIEW, REGISTERED หรือ PENDING_TRANSFER)
คีย์	ใบรับรอง/คีย์สาธารณะที่เฉพาะเจาะจงซึ่งใช้ลงนามในชื่อแพ็กเกจ Android รวมถึงแฮช SHA-256 และสถานะการลงทะเบียนปัจจุบัน (DRAFT, OWNERSHIP_VERIFIED, IN_REVIEW, REGISTERED หรือ PENDING_TRANSFER)

เริ่มต้นใช้งาน

ทำตามขั้นตอนต่อไปนี้เพื่อเข้าถึง Android Developer Console API

สร้างโปรเจ็กต์ Google Cloud

1. สร้างบัญชี Google Cloud หากยังไม่มี
2. เปิด คอนโซล Google Cloud
3. สร้างโปรเจ็กต์ Google Cloud

เปิดใช้ API ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

1. เปิด คอนโซล Google Cloud
2. ในเมนูการนำทาง (☰) ให้เลือก API และบริการ > ไลบรารี
3. เลือกโปรเจ็กต์ Google Cloud ที่ต้องการเปิดใช้ API จากเมนูแบบเลื่อนลงของโปรเจ็กต์
4. ใช้แถบค้นหา API และบริการ เพื่อเลือก Android Developer Console API
5. เปิดใช้ API โดยทำดังนี้
   1. ไปที่หน้าภาพรวมของ API โดยเลือก API จากผลการค้นหา
   2. คลิกปุ่มเปิดใช้สีน้ำเงิน Google Cloud จะเปิดใช้งาน API สำหรับโปรเจ็กต์ที่คุณเลือก ซึ่งโดยปกติจะใช้เวลาเพียงครู่เดียว เมื่อเปิดใช้แล้ว คุณก็เริ่มใช้งานได้

ตรวจสอบสิทธิ์ API

หากต้องการเรียกใช้ Android Developer Console API คุณต้องตรวจสอบสิทธิ์คำขอโดยใช้ OAuth 2.0

ตรวจสอบสิทธิ์ด้วย OAuth 2.0

Android Developer Console API ต้องใช้การตรวจสอบสิทธิ์ OAuth 2.0 เพื่อให้สิทธิ์เข้าถึงแหล่งข้อมูลบัญชีนักพัฒนาแอปและชื่อแพ็กเกจ เนื่องจากข้อมูลบัญชีนักพัฒนาแอปเชื่อมโยงกับบัญชี Google ของผู้ใช้ ไม่ใช่โปรเจ็กต์ Google Cloud ดังนั้นจึงไม่สามารถใช้บัญชีบริการ, Workload Identity Federation และคีย์ API เพื่อตรวจสอบสิทธิ์คำขอ API ได้

ขอบเขต OAuth 2.0

การดำเนินการทั้งหมดต้องใช้ขอบเขตต่อไปนี้

ขอบเขต OAuth 2.0	คำอธิบาย
https://www.googleapis.com/auth/androiddeveloperconsole	ดูและจัดการชื่อแพ็กเกจและข้อมูลในบัญชี Android Developer Console

ใช้ขั้นตอน OAuth 2.0 สำหรับเว็บเซิร์ฟเวอร์

แอปพลิเคชันต้องใช้ ขั้นตอน OAuth 2.0 สำหรับเว็บเซิร์ฟเวอร์เพื่อผสานรวมกับ Android Developer Console API คุณสามารถเลือกกลยุทธ์การจัดการข้อมูลเข้าสู่ระบบหลัก 2 แบบได้โดยขึ้นอยู่กับประเภทแอปพลิเคชันและความต้องการด้านระบบอัตโนมัติ

ตัวเลือก ก (แนะนำ): การเข้าถึงแบบออฟไลน์ / อัตโนมัติ (การผสานรวม CI/CD และเซิร์ฟเวอร์)

ตัวเลือก ข: การเข้าถึงแบบชั่วคราว / แบบโต้ตอบ

กลยุทธ์นี้ช่วยให้กระบวนการอัตโนมัติ (เช่น ไปป์ไลน์ CI/CD) ทำงานในเบื้องหลังได้โดยไม่ต้องมีการแทรกแซงจากเจ้าหน้าที่: การตั้งค่าความยินยอมของผู้ใช้แบบครั้งเดียว: ในระหว่างการตั้งค่าเริ่มต้น นักพัฒนาแอปหรือเจ้าของบัญชีจะทำตามขั้นตอนความยินยอมแบบครั้งเดียวในเบราว์เซอร์ แอปพลิเคชันจะขอสิทธิ์เข้าถึงแบบออฟไลน์ (access_type=offline) พร้อมกับขอบเขต API Google จะแสดงรหัสการให้สิทธิ์ ซึ่งแอปพลิเคชันจะแลกเปลี่ยนเป็นโทเค็นเพื่อการเข้าถึง เริ่มต้นและโทเค็นการรีเฟรช ที่ใช้ได้นาน การดำเนินการในเบื้องหลัง: จัดเก็บ refresh_token อย่างปลอดภัยในสภาพแวดล้อมการติดตั้งใช้งานหรือตัวจัดการ Secret (เช่น Secret ของ GitHub Actions, Google Secret Manager) สำหรับการเรียก API ครั้งต่อๆ ไป เวิร์กโฟลว์อัตโนมัติจะใช้โทเค็นการรีเฟรชที่จัดเก็บไว้เพื่อรับโทเค็นเพื่อการเข้าถึงใหม่ที่ใช้ได้ในระยะสั้นตามความต้องการ โดยข้ามการเข้าสู่ระบบด้วยตนเองหรือการแจ้งเตือน 2FA

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

ลงทะเบียนชื่อแพ็กเกจ

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

ลงทะเบียนชื่อแพ็กเกจใหม่

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

ลงทะเบียนชื่อแพ็กเกจที่มีอยู่

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

หากคีย์ที่คุณลงทะเบียนแสดงเป็น "ต้องมีเหตุผล" คุณยังคงลงทะเบียนคีย์ได้ แต่ต้องแสดงเหตุผลในการใช้ชื่อแพ็กเกจด้วย นอกเหนือจากการแสดงหลักฐานการเป็นเจ้าของ

กฎการมีสิทธิ์ของคีย์

ระบบจะกำหนดรายการคีย์ที่มีสิทธิ์ตามกฎการมีสิทธิ์ของชื่อแพ็กเกจที่ออกแบบมาเพื่อลดการใช้ชื่อแพ็กเกจร่วมกัน (เปิดตัวเป็นส่วนหนึ่งของการยืนยันนักพัฒนาแอป Android)

ในกรณีที่นักพัฒนาแอปหลายรายใช้ชื่อแพ็กเกจเดียวกันหรือมีคีย์ Signing หลายรายการ ระบบจะพิจารณาการมีสิทธิ์ดังนี้

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

ยืนยันการเป็นเจ้าของคีย์

หากต้องการยืนยันชื่อแพ็กเกจที่มีอยู่ให้เสร็จสมบูรณ์ API จะแสดงสตริงการยืนยัน คุณต้องใส่สตริงการยืนยันนี้ไว้ในไฟล์ใหม่ชื่อ adi-registration.properties ภายในโฟลเดอร์เนื้อหาของแอป จากนั้นคุณต้องรับรองและอัปโหลด APK โดยใช้คีย์ส่วนตัวที่ตรงกับคีย์สาธารณะที่คุณลงทะเบียน

แสดงเหตุผลในการลงทะเบียนคีย์

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

แนวทางปฏิบัติแนะนำสำหรับประสบการณ์ของผู้ใช้

เราขอแนะนำให้แอปพลิเคชันที่ใช้ Android Developer Console API ทำตามรูปแบบเหล่านี้เพื่อให้การผสานรวมเป็นไปอย่างราบรื่น

สร้างบริบทการให้สิทธิ์ OAuth ที่ชัดเจน

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

จัดโครงสร้างบริบทการให้สิทธิ์โดยใช้รูปแบบต่อไปนี้

• ชื่อ: "ลิงก์บัญชี Android Developer Console"
• สรุป: "จัดการการลงทะเบียนชื่อแพ็กเกจสำหรับการยืนยันนักพัฒนาแอป Android ภายใน [ชื่อแอปพลิเคชัน]"
• ปุ่มการดำเนินการ: ปุ่ม "ดำเนินการต่อด้วย Google" หรือ "ลงชื่อเข้าใช้ด้วย Google"

ระบุบัญชีนักพัฒนาแอป

1. ผสานรวมกับเมธอด ListDeveloperAccounts API เพื่อดึงและแสดงบัญชีนักพัฒนาแอปทั้งหมดที่ได้รับอนุญาตให้เข้าถึง
2. ระบุตัวเลือกบัญชีเพื่อให้ผู้ใช้เลือกบัญชีนักพัฒนาแอปที่ต้องการได้
3. แสดง displayName ของบัญชีอย่างชัดเจน โดยใช้หมายเลขบัญชีจากช่อง name เป็นข้อมูลรอง
4. แสดงสถานะการยืนยันบัญชี (verificationState) ดังนี้
   • VERIFIED: ยืนยันข้อมูลประจำตัวของนักพัฒนาแอปที่ยืนยันแล้วด้วยสัญญาณภาพที่เป็นบวก (เช่น เครื่องหมายถูกสีเขียว)
   • NOT_VERIFIED: ระบุว่าการยืนยันไม่สมบูรณ์และจำกัดการลงทะเบียนแพ็กเกจสำหรับบัญชี คุณเลือกใส่ปุ่ม CTA หลักที่เปลี่ยนเส้นทางนักพัฒนาแอปไปยัง Android Developer Console เมื่อเลือกบัญชีได้

หากได้รับคำตอบที่ว่างเปล่าเนื่องจากไม่มีบัญชีนักพัฒนาแอปที่เชื่อมโยงกับบัญชี Google ให้นำนักพัฒนาแอปไปยัง Android Developer Console โดยใช้ปุ่ม CTA หลัก

จัดการชื่อแพ็กเกจ

1. ผสานรวมกับปลายทาง ListAndroidPackages API เพื่อดึงชื่อแพ็กเกจทั้งหมดที่เชื่อมโยงกับบัญชีนักพัฒนาแอป มอบอินเทอร์เฟซแบบรวมศูนย์ เช่น รายการหรือตาราง ให้นักพัฒนาแอปเพื่อตรวจสอบสถานะแพ็กเกจได้อย่างมีประสิทธิภาพ
2. แสดง packageName พร้อมกับสถานะการลงทะเบียนปัจจุบัน (DRAFT, IN_REVIEW, REGISTERED หรือ PENDING_TRANSFER) โดยใช้ตัวบ่งชี้ภาพที่แตกต่างกันสำหรับแต่ละสถานะ หากมีการระบุและบันทึก "ชื่อที่เข้าใจง่าย" ไว้ในระหว่างการสร้าง คุณสามารถใส่ชื่อดังกล่าวในการแสดงผลได้

จัดการคีย์

1. เรียกใช้ปลายทาง ListAndroidPackageKeys API เพื่อดึงคีย์ทั้งหมดที่เชื่อมโยงกับชื่อแพ็กเกจ โดยแสดงภาพรวมที่มีโครงสร้าง (เช่น ตารางหรือรายการ) ให้นักพัฒนาแอปเพื่อตรวจสอบสถานะการลงทะเบียน
2. แสดง certificateFingerprintSha256 สำหรับคีย์แต่ละรายการพร้อมกับสถานะการลงทะเบียน (DRAFT, OWNERSHIP_VERIFIED, IN_REVIEW, REGISTERED_ACTIVE หรือ PENDING_TRANSFER) โดยใช้ตัวบ่งชี้ภาพที่แตกต่างกันเพื่อแยกความแตกต่างระหว่างสถานะ

1. เปิดโอกาสให้นักพัฒนาแอปลงทะเบียนคีย์เพิ่มเติมภายใต้ชื่อแพ็กเกจที่มีอยู่โดยผสานรวมกับเมธอด CreateAndroidPackageKey API

ลงทะเบียนชื่อแพ็กเกจ

1. ใช้เลย์เอาต์แบบฟอร์มที่ให้นักพัฒนาแอปป้อนชื่อแพ็กเกจลงในช่องข้อความ หากแอปพลิเคชันของคุณยังไม่ได้รวบรวมข้อมูลนี้ (เช่น ผ่านการแจ้งเตือนก่อนหน้านี้)
2. เรียกใช้เมธอด CreateAndroidPackage API เพื่อลงทะเบียนชื่อแพ็กเกจภายใต้บัญชี นักพัฒนาแอป และเรียกใช้เมธอด GetAndroidPackageRegistrationPolicy API เพื่อกำหนดกฎการมีสิทธิ์ของคีย์ที่เกี่ยวข้อง
3. แจ้งให้นักพัฒนาแอปดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้โดยอิงตาม keySelectionStrategy ที่กำหนดไว้สำหรับชื่อแพ็กเกจ
   • หากตั้งค่า keySelectionStrategy เป็น SELECT_KEY_FROM_LIST ให้นักพัฒนาแอปเลือกคีย์ที่จะลงทะเบียนจากรายการ knownKeys ที่ระบุ (ซึ่งมีลายนิ้วมือของใบรับรอง SHA-256) เช่น ใช้ปุ่มตัวเลือก โฟลว์นี้ต้องมีการยืนยันการเป็นเจ้าของคีย์ (ดู ยืนยันการเป็นเจ้าของคีย์ด้านล่าง)
   • หากตั้งค่า keySelectionStrategy เป็น USE_ANY_KEY ให้แจ้งให้นักพัฒนาแอประบุคีย์โดยตรง ในกรณีนี้ไม่จำเป็นต้องมีการยืนยันการเป็นเจ้าของคีย์
4. เรียกใช้เมธอด CreateAndroidPackageKey API เพื่อเชื่อมโยงคีย์ที่เลือกกับชื่อแพ็กเกจใหม่

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

ยืนยันการเป็นเจ้าของคีย์

เมื่อตั้งค่า keySelectionStrategy เป็น SELECT_KEY_FROM_LIST นักพัฒนาแอปต้องพิสูจน์การเป็นเจ้าของคีย์ Signing ส่วนตัว หลักฐานการเป็นเจ้าของกำหนดให้ต้องส่ง APK ที่ลงนามแล้วซึ่งรวม verificationToken ที่ API สร้างขึ้น

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

• คอมโพเนนต์การแสดงโทเค็น: แสดง verificationToken อย่างชัดเจนภายในบล็อกข้อมูลโค้ด รวมถึงปุ่ม "คัดลอกไปยังคลิปบอร์ด" ที่ใช้งานง่าย
• วิธีการตั้งค่าสำหรับนักพัฒนาแอป: ระบุวิธีการโดยละเอียดที่แนะนำให้นักพัฒนาแอปวางไฟล์ adi-registration.properties ที่มี verificationToken ไว้ในโฟลเดอร์เนื้อหาของแอป
• พื้นที่วางเพื่อส่ง APK: จัดเตรียมพื้นที่วางเพื่ออัปโหลดไฟล์โดยเฉพาะเพื่อรับ APK ที่ลงนามแล้ว

แสดงเหตุผลในการลงทะเบียนคีย์

เมื่อคีย์ที่ทราบมีช่อง justificationRequired ตั้งค่าเป็น REQUIRED การลงทะเบียนคีย์ดังกล่าวพร้อมกับชื่อแพ็กเกจกำหนดให้นักพัฒนาแอปต้องแสดงเหตุผลทางธุรกิจอย่างละเอียด

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

ทำให้การยืนยันคีย์สำหรับคีย์ที่จัดการเป็นแบบอัตโนมัติ

หากแอปพลิเคชันของคุณจัดการคีย์ Signing ของนักพัฒนาแอป นักพัฒนาแอปจะลงนาม APK ด้วยตนเองเพื่อยืนยันการเป็นเจ้าของไม่ได้ คุณต้องเรียกใช้ VerifyAndroidPackageKeyOwnership API โดยอัตโนมัติในนามของนักพัฒนาแอป

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

ปฏิบัติตามหลักเกณฑ์การใช้แบรนด์

แอปพลิเคชันทั้งหมดที่ผสานรวมกับ Android Developer Console API ต้องปฏิบัติตามหลักเกณฑ์การใช้แบรนด์ต่อไปนี้เพื่อรักษาความเชื่อมั่นของผู้ใช้และรับประกันความโปร่งใส

คำศัพท์และการใช้อักษรตัวพิมพ์ใหญ่

เมื่ออ้างอิงถึงผลิตภัณฑ์ในเอกสารหรือสื่อที่แสดงต่อผู้ใช้ ให้ใช้ชื่อเต็มว่า Android Developer Console เสมอ ห้ามใช้คำย่อ "ADC"

โปรแกรมนี้ต้องเรียกว่าการยืนยันนักพัฒนาแอป Android ใช้การสะกดและการใช้อักษรตัวพิมพ์ใหญ่ตามนี้ทุกบริบท

ใช้คำว่า "ชื่อแพ็กเกจ" โดยเฉพาะแทนคำว่า "แพ็กเกจ" เพื่อป้องกันความคลุมเครือกับ APK หรือ AAB

เมื่ออธิบายกระบวนการเพิ่มชื่อแพ็กเกจ ให้ใช้คำว่า "ลงทะเบียนชื่อแพ็กเกจ" แทน "อ้างสิทธิ์ชื่อแพ็กเกจ"

ใช้คำกระตุ้นให้ดำเนินการ "ลงชื่อเข้าใช้"

การตรวจสอบสิทธิ์ OAuth 2.0 กับ Android Developer Console อาศัยบริการข้อมูลประจำตัวของ Google คุณต้องใช้คำกระตุ้นให้ดำเนินการ "ดำเนินการต่อด้วย Google" หรือ "ลงชื่อเข้าใช้ด้วย Google" ในปุ่มการให้สิทธิ์เพื่อให้เป็นไปตามหลักเกณฑ์การใช้แบรนด์ของ Google Identity Services ข้อความนี้เป็นข้อบังคับและแก้ไขไม่ได้ เนื่องจากข้อความนี้จะช่วยให้ผู้ใช้เข้าใจว่าตนกำลังใช้ข้อมูลเข้าสู่ระบบของ Google เพื่อให้สิทธิ์แอปพลิเคชันของคุณเข้าถึงบัญชี Google

รักษาเอกลักษณ์ของแบรนด์และความสมบูรณ์

เมื่อผสานรวมโลโก้ Android Developer Console เข้ากับอินเทอร์เฟซแอปพลิเคชัน คุณต้องทำตามข้อกำหนดต่อไปนี้เพื่อรักษาเอกลักษณ์ภาพและความสมบูรณ์ของแบรนด์

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

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

แหล่งข้อมูลเพิ่มเติม

• ตรวจสอบสถานะการลงทะเบียนแอปด้วย Android Developer ID Status API
• ลงทะเบียนใน Android Developer Console
• ลงทะเบียนใน Google Play Console
• รับรองแอป