Play Integrity API: คู่มือการลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์และโควต้า

Google Play Integrity API บังคับใช้ขีดจำกัดคำขอ 10,000 รายการต่อวันกับการเข้าชมจากโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Cloud ที่ไม่ได้ลิงก์กับแอปใน Google Play Console หรือ SDK ใน Play SDK Console ขีดจำกัดนี้มีผลบังคับใช้อยู่แล้วสำหรับโปรเจ็กต์ Google Cloud ส่วนใหญ่ โปรเจ็กต์จำนวนเล็กน้อยที่มีโควต้าเพิ่มขึ้นอยู่แล้วจะได้รับการขยายกำหนดเวลาจนถึงวันที่ 16 กุมภาพันธ์ 2027 เพื่อทำการลิงก์ให้เสร็จสมบูรณ์ก่อนที่จะมีการบังคับใช้ขีดจำกัด

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

สรุปสั้นๆ

รายละเอียดสำคัญ คำอธิบาย
วันที่บังคับใช้ เปิดใช้งานแล้วสำหรับโปรเจ็กต์ส่วนใหญ่
16 กุมภาพันธ์ 2027 สำหรับโปรเจ็กต์ที่ได้รับการแจ้งเตือนกำหนดเวลา
นโยบาย คำขอ Play Integrity API ที่มาจากโปรเจ็กต์ที่อยู่ในระบบคลาวด์ซึ่งไม่ได้ลิงก์กับแอปหรือ SDK ของคุณจะถูกจำกัดไว้ที่ 10,000 คำขอต่อวัน ไม่ว่าจะกำหนดโควต้าที่กำหนดเองไว้สูงกว่าในโปรเจ็กต์ก็ตาม
ผู้ที่ได้รับผลกระทบ แอปและ SDK ที่ส่งคำขอมากกว่า 10,000 รายการต่อวันโดยใช้โปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ที่ไม่ได้ลิงก์กับแอปนั้น (ใน Play Console) หรือ SDK (ใน Play SDK Console)
ขอให้ดำเนินการ ลิงก์โปรเจ็กต์ Google Cloud กับแอปใน Google Play Console หรือกับ SDK ใน Google Play SDK Console
ข้อผิดพลาดเกี่ยวกับโควต้าเกิน คำขอที่ไม่ได้ลิงก์ซึ่งเกิน 10,000 รายการต่อวันจะดำเนินการไม่สำเร็จและแสดงข้อผิดพลาด TOO_MANY_REQUESTS (รหัสข้อผิดพลาด -8)

คำถามที่พบบ่อย

Play Integrity API ให้โควต้าเริ่มต้นแก่โปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ทุกโปรเจ็กต์เป็นจำนวน 10,000 คำขอต่อวัน นักพัฒนาแอปที่ต้องการปริมาณที่สูงขึ้นสามารถขอเพิ่มโควต้าได้

เพื่อปกป้องแอปหรือ SDK และป้องกันไม่ให้บุคคลที่สามที่ไม่ได้รับอนุญาตใช้โควต้าของคุณจนหมด โควต้ารายวันที่เพิ่มขึ้นจะจำกัดไว้เฉพาะโปรเจ็กต์ Google Cloud ที่ลิงก์กับแอปของคุณใน Google Play Console หรือ SDK ของคุณใน Google Play SDK Console เท่านั้น

สำหรับแอป (Google Play Console)

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

สำหรับ SDK (Google Play SDK Console)

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

สิทธิ์ที่จำเป็น

  • Play Console (สำหรับแอป): คุณต้องมีสิทธิ์ "เผยแพร่เป็นเวอร์ชันที่ใช้งานจริง ทำการยกเว้นอุปกรณ์ และใช้ Play App Signing" สำหรับแอป
  • Play SDK Console (สำหรับ SDK): คุณต้องมีสิทธิ์"จัดการ" สำหรับ SDK
  • Google Cloud (ทั้ง 2 รายการ): คุณต้องมีสิทธิ์ "serviceusage.services.enable" และ "resourcemanager.projects.get" ในโปรเจ็กต์ Google Cloud เป้าหมาย

สำหรับแอป (Google Play Console)

  1. เปิด Google Play Console > ปกป้องด้วย Play > Play Integrity API > จัดการ
  2. ตรวจสอบส่วนการกำหนดค่าโปรเจ็กต์
  3. ตรวจสอบว่าหมายเลขโปรเจ็กต์ที่แสดงตรงกับหมายเลขที่ใช้เรียก Play Integrity API

สำหรับ SDK (Google Play SDK Console)

  1. เปิด Google Play SDK Console > ความสมบูรณ์ของ SDK > การตั้งค่า
  2. ตรวจสอบส่วนการกำหนดค่าโปรเจ็กต์
  3. ตรวจสอบว่าหมายเลขโปรเจ็กต์ที่แสดงตรงกับหมายเลขที่ใช้เรียก Play Integrity API

คำถามที่ 4: ฉันจะลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์ได้อย่างไรหากแอปหรือ SDK ของฉันไม่ได้อยู่ใน Google Play

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

หากแอปของคุณจัดจำหน่ายนอก Google Play เท่านั้นหรือ SDK ของคุณไม่ได้อยู่ใน Play SDK Console คุณจะลิงก์โปรเจ็กต์ Google Cloud ไม่ได้ และการเข้าชม Play Integrity API จะจำกัดอยู่ที่ 10,000 คำขอต่อวันโดยค่าเริ่มต้น หากต้องการมีสิทธิ์รับโควต้าที่สูงขึ้น ให้เผยแพร่แอปใน Google Play หรือลงทะเบียน SDK ที่มีสิทธิ์ใน Play SDK Console แล้วลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์

คำถามที่ 5: ฉันลิงก์โปรเจ็กต์ Google Cloud หลายโปรเจ็กต์ หรือแชร์โปรเจ็กต์เดียวในแอปหรือ SDK หลายรายการได้ไหม

  • หลายโปรเจ็กต์ต่อแอปหรือ SDK: คุณลิงก์โปรเจ็กต์ Google Cloud กับแอปหรือ SDK เดียวได้สูงสุด 5 โปรเจ็กต์
  • 1 โปรเจ็กต์ในหลายแอป: คุณลิงก์โปรเจ็กต์ Google Cloud เดียวกันกับหลายแอปใน Google Play Console ได้ ระบบไม่รองรับการลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google เดียวกันกับ SDK หลายรายการ หรือกับ SDK และแอป

คำถามที่ 6: ฉันควรทำอย่างไรหากฉันเป็นผู้จัดการแอปหรือ SDK แต่บุคคลอื่นในองค์กรเป็นเจ้าของโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

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

  • ตัวเลือก ก: ขอให้ผู้ที่สามารถจัดการสิทธิ์เข้าถึง IAM ในโปรเจ็กต์ Google Cloud ให้สิทธิ์ "serviceusage.services.enable" และ "resourcemanager.projects.get" แก่บัญชี Google ของคุณชั่วคราว เมื่อลิงก์แล้ว คุณไม่จำเป็นต้องใช้สิทธิ์เหล่านี้สำหรับการดำเนินการในแต่ละวันอีกต่อไป
  • ตัวเลือก ข: ให้สิทธิ์เข้าถึง Console ที่จำเป็นแก่สมาชิกในทีมที่มีสิทธิ์ "serviceusage.services.enable" และ "resourcemanager.projects.get" ในโปรเจ็กต์ Google Cloud อยู่แล้ว เพื่อให้สมาชิกรายดังกล่าวทำขั้นตอนการลิงก์ได้ ดังนี้
    • สำหรับแอป (Play Console): ให้สิทธิ์ "เผยแพร่เป็นเวอร์ชันที่ใช้งานจริง ทำการยกเว้นอุปกรณ์ และใช้ Play App Signing" สำหรับแอป
    • สำหรับ SDK (Play SDK Console): ให้สิทธิ์ "จัดการ" สำหรับ SDK

คำถามที่ 7: จะเกิดอะไรขึ้นหากฉันไม่ลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์ก่อนวันที่ 16 กุมภาพันธ์ 2027

หากแอปหรือ SDK ส่งคำขอ Play Integrity API โดยใช้โปรเจ็กต์ Google Cloud ที่ไม่ได้ลิงก์หลังจากวันที่ 16 กุมภาพันธ์ 2027 จะเกิดเหตุการณ์ต่อไปนี้

  1. คำขอสูงสุด 10,000 รายการต่อวัน: คำขอจะยังคงสำเร็จตามปกติภายใต้โควต้าพื้นฐานเริ่มต้น
  2. คำขอมากกว่า 10,000 รายการต่อวัน: เมื่อโปรเจ็กต์ที่ไม่ได้ลิงก์มีคำขอถึง 10,000 รายการต่อวัน ระบบจะปฏิเสธคำขอพร้อมข้อผิดพลาด TOO_MANY_REQUESTS (รหัสข้อผิดพลาด -8)

การแก้ไขด้วยตนเองแบบทันที:

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

คำถามที่ 8: ฉันไม่ได้ใช้ Play Integrity API เหตุใดฉันจึงได้รับข้อความขอให้ลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์

คุณได้รับประกาศนี้เนื่องจากโปรเจ็กต์ Google Cloud ของคุณสร้างคำขอ Play Integrity API ที่ไม่ได้ลิงก์มากกว่า 10,000 รายการต่อวัน สาเหตุที่พบบ่อยมีดังนี้

  1. ไลบรารีหรือ SDK ที่กำหนดค่าด้วยหมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์: ไลบรารีบางรายการจะเรียกใช้ Play Integrity API โดยใช้โปรเจ็กต์ Google Cloud ของคุณ หากแอปหรือ SDK ของคุณใช้ไลบรารีดังกล่าว ให้ลิงก์โปรเจ็กต์นั้นกับแอปใน Play Console หรือกับ SDK ใน Play SDK Console
  2. แอปหรือทีมอื่นในองค์กร: ทีมอื่นอาจใช้โปรเจ็กต์ Google Cloud นี้ในแอปหรือ SDK ของตน ตรวจสอบกับทีมวิศวกรเพื่อระบุแอปหรือ SDK จากนั้นลิงก์โปรเจ็กต์ใน Play Console หรือ Play SDK Console
  3. การเข้าชมที่ไม่ได้รับอนุญาตหรือการผสานรวมที่เลิกใช้แล้ว: หากแอปที่ไม่ได้รับอนุญาตหรือแอปโคลนส่งคำขอด้วยหมายเลขโปรเจ็กต์ของคุณ หรือหากคุณไม่ได้ใช้ API อีกต่อไป ก็ไม่จำเป็นต้องดำเนินการใดๆ การปล่อยให้ขีดจำกัดคำขอที่ไม่ได้ลิงก์ 10,000 รายการต่อวันมีผลจะช่วยจำกัดการเข้าชมที่ไม่พึงประสงค์ได้

การติดต่อและการสนับสนุน

หากมีคำถามเกี่ยวกับการลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์ หรือการจัดการโควต้า Play Integrity API ให้ทำดังนี้