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

หากต้องการพัฒนาแอปโดยใช้ บริการ Google Play API ให้ทำตามวิธีการในหน้านี้เพื่อตั้ง ค่าโปรเจ็กต์ด้วย 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 ในแอป ให้ทำตามขั้นตอนต่อไปนี้

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

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

ข้อมูลโค้ดต่อไปนี้แสดงตัวอย่างไฟล์ 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 อย่างไรก็ตาม อุปกรณ์ที่ไม่มี Google Play Store จะไม่ได้ติดตั้งบริการ Google Play หากแอปทำงานในอุปกรณ์ที่ไม่มีบริการ Google Play คุณควรตรวจสอบเสมอว่าได้ติดตั้งบริการ Google Play แล้วก่อนที่จะพยายามใช้ Google APIs หรือเปิดใช้ฟีเจอร์ที่ต้องใช้บริการ Google Play

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

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

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

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

**ตารางที่ 1** ทรัพยากร Dependency ของบริการ Google Play ที่จะรวมไว้ใน แอป Android
กรณีการใช้งานและชื่อทรัพยากร Dependency	อุปกรณ์ที่รองรับ
Google Mobile Ads `com.google.android.gms:play-services-ads:25.2.0`	โทรศัพท์, แท็บเล็ต
รหัสโฆษณา Android (AAID) `com.google.android.gms:play-services-ads-identifier:18.3.0`	โทรศัพท์, แท็บเล็ต, Android TV, ChromeOS
Google Mobile Ads เวอร์ชันขนาดเล็ก `com.google.android.gms:play-services-ads-lite:24.8.0`	โทรศัพท์, แท็บเล็ต
AdSense for Search (AFS) Custom Search Ads (CSA) `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.5.1`	โทรศัพท์, แท็บเล็ต, Android TV, Auto, Android Go, ChromeOS
SMS Retriever API `com.google.android.gms:play-services-auth-api-phone:18.3.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:20.0.0`	โทรศัพท์, แท็บเล็ต, Auto, Android Go, ChromeOS
คลาสยูทิลิตี `com.google.android.gms:play-services-base:18.10.0`	โทรศัพท์, แท็บเล็ต, Android TV, Auto, Android Go, ChromeOS, Wear OS
การทดสอบข้อมูลจำลองสำหรับคลาสยูทิลิตี `com.google.android.gms:play-services-base-testing:16.2.0`	โทรศัพท์, แท็บเล็ต, Android TV, Auto, Android Go, ChromeOS, Wear OS
คลาสยูทิลิตีเพิ่มเติม `com.google.android.gms:play-services-basement:18.10.0`	โทรศัพท์, แท็บเล็ต, Android TV, Auto, Android Go, ChromeOS, Wear OS
การเพิ่มประสิทธิภาพกล้องในที่แสงน้อย `com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta07`	โทรศัพท์, แท็บเล็ต
Google Cast `com.google.android.gms:play-services-cast:22.3.1`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
Google Cast Application Framework (CAF) `com.google.android.gms:play-services-cast-framework:22.3.1`	โทรศัพท์, แท็บเล็ต, 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.1`	โทรศัพท์, แท็บเล็ต, Android TV, Auto, Android Go, ChromeOS, Wear OS
การโต้ตอบระหว่างอุปกรณ์ (DTDI) `com.google.android.gms:play-services-dtdi:16.0.0-beta02`	โทรศัพท์, แท็บเล็ต, Android Go
Key Verifier SDK `com.google.android.gms:contactkeys:16.0.0`	โทรศัพท์, แท็บเล็ต
การตรวจสอบสิทธิ์ Fast IDentity Online (FIDO) `com.google.android.gms:play-services-fido:21.2.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.3.0`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS, Wear OS
บริการเกมของ Google Play เวอร์ชัน 2 สำหรับ Android `com.google.android.gms:play-services-games-v2:21.0.0`	โทรศัพท์, แท็บเล็ต, Android TV, Android Go, ChromeOS
บริการเกมของ Google Play v2 Native C SDK สำหรับ Android `com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1`	โทรศัพท์, แท็บเล็ต, Android TV, Android Go, ChromeOS
บริการเกมของ Google Play เวอร์ชัน 1 สำหรับ Android `com.google.android.gms:play-services-games:24.0.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.2.0`	เลิกใช้งานแล้ว ดูข้อมูลเพิ่มเติมได้ที่ Google Play Instant
บริการตำแหน่งสำหรับ 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:20.0.0`	โทรศัพท์, แท็บเล็ต, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Maps 3D SDK สำหรับ Android `com.google.android.gms:play-services-maps3d:0.2.0`	โทรศัพท์, แท็บเล็ต
การเพิ่มประสิทธิภาพเอฟเฟกต์สื่อ `com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta03`	โทรศัพท์, แท็บเล็ต
การสแกนบาร์โค้ด 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`	โทรศัพท์, แท็บเล็ต, 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.5.1`	โทรศัพท์, แท็บเล็ต, Android TV, Auto, Android Go, ChromeOS รองรับในอุปกรณ์ที่ใช้ Android 5.0 (ระดับ API 21) ขึ้นไป
ไลบรารีการเข้าถึงแบบเป็นโปรแกรม (PAL) `com.google.android.gms:play-services-pal:23.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 for Passes) `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 APIs (รวมถึง Safe Browsing และ Verify Apps) `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.3.0`	โทรศัพท์, แท็บเล็ต, Android TV, Android Go, ChromeOS
Tasks API ใน Android `com.google.android.gms:play-services-tasks:18.4.1`	โทรศัพท์, แท็บเล็ต, Android TV, Auto, Android Go, ChromeOS, Wear OS
Acceleration Service สำหรับ Android `com.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
TensorFlow Lite GPU Delegate API สำหรับบริการ Google Play `com.google.android.gms:play-services-tflite-gpu:16.5.0`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
TensorFlow Lite Java API สำหรับบริการ Google Play `com.google.android.gms:play-services-tflite-java:16.5.0`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
TensorFlow Lite Support API สำหรับบริการ Google Play `com.google.android.gms:play-services-tflite-support:16.5.0`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
Thread Network API `com.google.android.gms:play-services-threadnetwork:16.3.0`	โทรศัพท์, แท็บเล็ต
Trusted Time API `com.google.android.gms:play-services-time:16.0.1`	โทรศัพท์, แท็บเล็ต, Auto, Android Go, Wear OS
Mobile Vision `com.google.android.gms:play-services-vision:20.1.3`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
Google Pay สำหรับการชำระเงินใน Android `com.google.android.gms:play-services-wallet:20.0.0`	โทรศัพท์, แท็บเล็ต, Auto, Android Go, ChromeOS, Wear OS
Wearable Data Layer API `com.google.android.gms:play-services-wearable:20.0.1`	โทรศัพท์, แท็บเล็ต, Wear OS

ปลั๊กอิน Gradle

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

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