ตั้งค่าบริการ Google Play

หากต้องการพัฒนาแอปโดยใช้ API บริการของ Google Play ให้ทำตามวิธีการในหน้านี้เพื่อตั้งค่าโปรเจ็กต์ด้วย SDK ที่เกี่ยวข้อง ซึ่งมีอยู่ในที่เก็บ Maven ของ Google

หากต้องการทดสอบแอปเมื่อใช้บริการ Google Play คุณต้องดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้

  • อุปกรณ์ Android ที่เข้ากันได้ซึ่งใช้ Android 6.0 (API ระดับ 23) ขึ้นไปและมีการติดตั้งแอป Google Play Store
  • โปรแกรมจําลอง Android ที่มี AVD ที่เรียกใช้แพลตฟอร์ม Google APIs อิงตาม Android 6.0 (API ระดับ 23) ขึ้นไป

ประกาศทรัพยากร Dependency สำหรับบริการ Google Play

หากต้องการพัฒนาฟีเจอร์ที่ขึ้นอยู่กับ API ของบริการ Google Play ในแอป ให้ทำตามขั้นตอนต่อไปนี้

  1. เปิดไฟล์ build.gradle ในไดเรกทอรีโมดูลของแอป

  2. ใส่ Dependency ของ SDK แต่ละรายการที่แอปของคุณต้องใช้ หน้านี้มีส่วนแสดงรายการบริการ Google Play ที่ต้องมีโดยทั่วไปสำหรับแอป Android คุณอาจต้องเพิ่ม Dependency ของ Firebase ลงในโปรเจ็กต์ด้วย

  3. บันทึกการเปลี่ยนแปลงและซิงค์โปรเจ็กต์

ตัวอย่างข้อมูลต่อไปนี้แสดงไฟล์ build.gradle ที่ใช้คลังสถานที่

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.3.0'
}

SDK บริการ Google Play เวอร์ชันใหม่ที่มีการแก้ไขข้อบกพร่องและฟีเจอร์ใหม่ๆ จะเผยแพร่เป็นระยะ เราจะประกาศการอัปเดตเหล่านี้ในบันทึกประจำรุ่น หากแอปใช้ทรัพยากร Dependency ที่อัปเดตแล้ว ให้เปลี่ยนเป็นเวอร์ชันล่าสุดในทรัพยากร Dependency ของแอปเพื่อใช้ประโยชน์จากการแก้ไขเหล่านี้

ตรวจสอบว่าได้ติดตั้งบริการ Google Play แล้ว

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

หากต้องการตรวจสอบว่ามีบริการ Google Play ในอุปกรณ์หรือไม่ ให้ใช้วิธี isGooglePlayServicesAvailable()

หากต้องการเริ่มเชื่อมต่อกับบริการ Google Play หรือดูวิธีตรวจหาว่าบริการ Google Play เวอร์ชันที่ติดตั้งรองรับ API ที่เฉพาะเจาะจงหรือไม่ ให้อ่านคำแนะนำเกี่ยวกับการเข้าถึง Google API

ทรัพยากร Dependency ของบริการ Google Play

ตารางต่อไปนี้แสดงรายการทรัพยากรที่ต้องพึ่งพาสำหรับบริการ Google Play ที่คุณรวมไว้ในแอป Android ได้ คุณสามารถกรองรายการตามประเภทอุปกรณ์โดยเลือกปุ่มใดปุ่มหนึ่ง และค้นหา Use Case หรือชื่อทรัพยากรที่ต้องพึ่งพาที่เฉพาะเจาะจงโดยป้อนข้อความในช่องที่ปรากฏหลังปุ่ม

ตารางที่ 1 ไลบรารีของบริการ Google Play ที่จะรวมไว้ในแอป Android
ชื่อ Use Case และ Dependency อุปกรณ์ที่รองรับ
Google Mobile Ads
com.google.android.gms:play-services-ads:23.6.0
โทรศัพท์ แท็บเล็ต
รหัสโฆษณา Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.1.0
โทรศัพท์ แท็บเล็ต Android TV, ChromeOS
Google Mobile Ads เวอร์ชันน้ำหนักเบา
com.google.android.gms:play-services-ads-lite:23.6.0
โทรศัพท์ แท็บเล็ต
โฆษณา Search ที่กําหนดเอง (CSA) ของ AdSense สําหรับ Search (AFS)
com.google.android.gms:play-services-afs-native:19.1.0
โทรศัพท์ แท็บเล็ต ChromeOS
SDK บริการ Google Analytics สําหรับ Android
com.google.android.gms:play-services-analytics:18.1.1
เลิกใช้งานแล้ว ให้ใช้ Google Analytics สําหรับ Firebase แทน
App Index
com.google.android.gms:play-services-appindex:16.2.0
โทรศัพท์ แท็บเล็ต Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.1
โทรศัพท์ แท็บเล็ต Android TV
รหัสชุดแอป Android
com.google.android.gms:play-services-appset:16.1.0
โทรศัพท์ แท็บเล็ต Android TV, ChromeOS
Google Sign-In สำหรับ Android
com.google.android.gms:play-services-auth:21.2.0
โทรศัพท์ แท็บเล็ต Android TV, Auto, Android Go, ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.1.0
โทรศัพท์ แท็บเล็ต Android Go
Block Store API (รวมถึงพื้นที่เก็บข้อมูลเข้าสู่ระบบของผู้ใช้)
com.google.android.gms:play-services-auth-blockstore:16.4.0
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.1.0
โทรศัพท์ แท็บเล็ต รถยนต์ Android Go, ChromeOS
คลาสยูทิลิตี
com.google.android.gms:play-services-base:18.5.0
โทรศัพท์ แท็บเล็ต Android TV, Auto, Android Go, ChromeOS, Wear OS
การทดสอบข้อมูลจำลองสำหรับคลาสยูทิลิตี
com.google.android.gms:play-services-base-testing:16.1.0
โทรศัพท์ แท็บเล็ต Android TV, Auto, Android Go, ChromeOS, Wear OS
คลาสยูทิลิตีเพิ่มเติม
com.google.android.gms:play-services-basement:18.5.0
โทรศัพท์ แท็บเล็ต Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:22.0.0
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
เฟรมเวิร์กแอปพลิเคชัน Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:22.0.0
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
Google Code Scanner
com.google.android.gms:play-services-code-scanner:16.1.0
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
สแต็กเครือข่าย Chromium (Cronet)
com.google.android.gms:play-services-cronet:18.1.0
โทรศัพท์ แท็บเล็ต Android TV, Auto, Android Go, ChromeOS, Wear OS
การโต้ตอบระหว่างอุปกรณ์ (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta02
โทรศัพท์ แท็บเล็ต Android Go
การตรวจสอบสิทธิ์ Fast Identity Online (FIDO)
com.google.android.gms:play-services-fido:21.1.0
โทรศัพท์ แท็บเล็ต, Android TV, Auto, Android Go, ChromeOS, Wear OS

ใช้ได้ในอุปกรณ์ที่ใช้ Android 7.0 (API ระดับ 24) ขึ้นไป
Google Fit API สําหรับ Android และ Recording API บนอุปกรณ์เคลื่อนที่ (สําหรับข้อมูลการออกกําลังกายของผู้ใช้)
com.google.android.gms:play-services-fitness:21.2.0
โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS, Wear OS
บริการ Google Play Games v2 สำหรับ Android
com.google.android.gms:play-services-games-v2:20.1.2
โทรศัพท์ แท็บเล็ต Android TV, Android Go, ChromeOS
SDK C เนทีฟ v2 ของบริการเกม Google Play สำหรับ Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
โทรศัพท์ แท็บเล็ต Android TV, Android Go, ChromeOS
บริการ Google Play Games v1 สำหรับ Android
com.google.android.gms:play-services-games:23.2.0
โทรศัพท์ แท็บเล็ต Android TV, Android Go, ChromeOS
Matter API
com.google.android.gms:play-services-home:16.0.0
โทรศัพท์ แท็บเล็ต
Google Play Instant
com.google.android.gms:play-services-instantapps:18.1.0
โทรศัพท์ แท็บเล็ต, Android TV, Android Go, ChromeOS

ใช้ได้ในอุปกรณ์ที่ใช้ Android 5.0 (API ระดับ 21) ขึ้นไป
บริการตำแหน่งสำหรับ Android
com.google.android.gms:play-services-location:21.3.0
โทรศัพท์ แท็บเล็ต Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Maps SDK สําหรับ Android
com.google.android.gms:play-services-maps:19.0.0
โทรศัพท์ แท็บเล็ต Android TV, Auto, Android Go, ChromeOS, Wear OS
การสแกนบาร์โค้ดของ ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
เครื่องสแกนเอกสาร ML Kit
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
การตรวจจับใบหน้าของ ML Kit
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
การติดป้ายกำกับรูปภาพ ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
การติดป้ายกำกับรูปภาพ ML Kit ที่กําหนดเอง
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
การระบุภาษาของ ML Kit
com.google.android.gms:play-services-mlkit-language-id:17.0.0
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
ฟีเจอร์ช่วยตอบของ ML Kit
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
การแบ่งกลุ่มเรื่องใน ML Kit
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
การจดจำข้อความ ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
การจดจำข้อความ ML Kit สำหรับภาษาจีน
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
การจดจำข้อความ ML Kit สำหรับเทวนาครี
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
การจดจำข้อความของ ML Kit สำหรับภาษาญี่ปุ่น
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
การจดจำข้อความ ML Kit สำหรับภาษาเกาหลี
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
การค้นหาและการเชื่อมต่ออุปกรณ์ที่อยู่ใกล้เคียง
com.google.android.gms:play-services-nearby:19.3.0
โทรศัพท์ แท็บเล็ต Android TV, Auto, Android Go
แสดงใบอนุญาตโอเพนซอร์ส
com.google.android.gms:play-services-oss-licenses:17.1.0
โทรศัพท์ แท็บเล็ต, Android TV, Auto, Android Go, ChromeOS
ใช้ได้ในอุปกรณ์ที่ใช้ Android 5.0 (API ระดับ 21) ขึ้นไป
ไลบรารีการเข้าถึงแบบเป็นโปรแกรม (PAL)
com.google.android.gms:play-services-pal:21.0.0
โทรศัพท์ แท็บเล็ต Android TV
ใช้ได้ในอุปกรณ์ที่ใช้ Android 5.0 (API ระดับ 21) ขึ้นไป
การตรวจสอบคุณภาพการล็อกหน้าจอ
com.google.android.gms:play-services-password-complexity:18.1.0
โทรศัพท์ แท็บเล็ต, Android Go, ChromeOS, Wear OS

ใช้งานได้ในอุปกรณ์ที่ใช้ Android 4.4 (API ระดับ 19) ถึง Android 9 (API ระดับ 28)
Google Wallet (เดิมคือ Google Pay สำหรับบัตร)
com.google.android.gms:play-services-pay:16.5.0
โทรศัพท์ แท็บเล็ต, Android Go, ChromeOS

ใช้ได้ในอุปกรณ์ที่ใช้ Android 5.0 (API ระดับ 20) ขึ้นไป
reCAPTCHA Enterprise สําหรับเครื่องมือวัดผลแอป
com.google.android.gms:play-services-recaptcha:17.1.0
โทรศัพท์ แท็บเล็ต Android TV, Android Go, ChromeOS
SafetyNet API (รวมถึงการรับรองอุปกรณ์, Google Safe Browsing, reCAPTCHA และการยืนยันแอป)
com.google.android.gms:play-services-safetynet:18.1.0
โทรศัพท์ แท็บเล็ต Android TV, Auto, Android Go, ChromeOS
Google Tag Manager
com.google.android.gms:play-services-tagmanager:18.1.1
โทรศัพท์ แท็บเล็ต Android TV, Android Go, ChromeOS
Tasks API ใน Android
com.google.android.gms:play-services-tasks:18.2.0
โทรศัพท์ แท็บเล็ต Android TV, Auto, Android Go, ChromeOS, Wear OS
บริการเร่งความเร็วสำหรับ Android
com.google.android.gms:play-services-tflite-acceleration-service:16.3.0-beta01
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
TensorFlow Lite GPU Delegate API สําหรับบริการ Google Play
com.google.android.gms:play-services-tflite-gpu:16.3.0
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
TensorFlow Lite Java API สําหรับบริการ Google Play
com.google.android.gms:play-services-tflite-java:16.3.0
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
TensorFlow Lite Support API สำหรับบริการ Google Play
com.google.android.gms:play-services-tflite-support:16.3.0
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.2.1
โทรศัพท์ แท็บเล็ต
Mobile Vision
com.google.android.gms:play-services-vision:20.1.3
โทรศัพท์ แท็บเล็ต Android Go, ChromeOS
Google Pay for Payments ใน Android
com.google.android.gms:play-services-wallet:19.4.0
โทรศัพท์ แท็บเล็ต รถยนต์ Android Go, ChromeOS, Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:19.0.0
โทรศัพท์ แท็บเล็ต Wear OS

ปลั๊กอิน Gradle

บริการ Google Play ยังมีปลั๊กอิน Gradle หลายรายการดังที่แสดงในตารางต่อไปนี้ โปรดทราบว่าปุ่มที่ปรากฏก่อนตารางก่อนหน้าจะไม่เปลี่ยนแปลงข้อมูลที่ปรากฏในตารางนี้

ตารางที่ 2 รายการปลั๊กอิน Gradle ที่รวมอยู่ในบริการ Google Play
Use Case และชื่อปลั๊กอิน Gradle อุปกรณ์ที่รองรับ
แสดงใบอนุญาตโอเพนซอร์ส
com.google.android.gms:oss-licenses-plugin:0.10.6
โทรศัพท์ แท็บเล็ต ChromeOS
การตรวจสอบเวอร์ชันอย่างเข้มงวด
com.google.android.gms:strict-version-matcher-plugin:1.2.4
โทรศัพท์ แท็บเล็ต Android TV, Auto, Android Go, ChromeOS, Wear OS