หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

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

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

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

ทําตามขั้นตอนต่อไปนี้เพื่อพัฒนาฟีเจอร์ที่ใช้ API ของบริการ Google Play ในแอป

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

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

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

apply plugin: 'com.android.application'

...

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

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

ตรวจสอบว่ามีการติดตั้งบริการ Google Play หรือไม่

ตามที่อธิบายไว้ในภาพรวมบริการ Google Play บริการ Google Play จะได้รับการอัปเดตโดยอัตโนมัติใน Android 4.4 (API ระดับ 19) ขึ้นไป ผ่านแอป 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

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

**ตารางที่ 1** ทรัพยากร Dependency ของบริการ Google Play ที่จะรวมในแอป Android
กรณีการใช้งานและชื่อทรัพยากร Dependency	อุปกรณ์ที่รองรับ
โฆษณาในอุปกรณ์เคลื่อนที่ของ Google `com.google.android.gms:play-services-ads:22.0.0`	โทรศัพท์ แท็บเล็ต
รหัสโฆษณา Android (AAID) `com.google.android.gms:play-services-ads-identifier:18.0.1`	โทรศัพท์, แท็บเล็ต, Android TV, ChromeOS
โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ที่มีน้ําหนักเบา `com.google.android.gms:play-services-ads-lite:22.0.0`	โทรศัพท์ แท็บเล็ต
โฆษณาที่กําหนดเองในเครือข่าย Search (CSA) ของ AdSense สําหรับ Search (AFS) `com.google.android.gms:play-services-afs-native:19.0.3`	โทรศัพท์, แท็บเล็ต, ChromeOS
SDK บริการ Google Analytics สําหรับ Android `com.google.android.gms:play-services-analytics:18.0.2`	เลิกใช้งานแล้ว โปรดใช้ Google Analytics สําหรับ Firebase แทน
ดัชนีแอป `com.google.android.gms:play-services-appindex:16.1.0`	โทรศัพท์, แท็บเล็ต, Android TV
รหัสชุดแอป Android `com.google.android.gms:play-services-appset:16.0.2`	โทรศัพท์, แท็บเล็ต, Android TV, ChromeOS
Google Sign-In สําหรับ Android `com.google.android.gms:play-services-auth:20.4.1`	โทรศัพท์, แท็บเล็ต, Android TV, ยานยนต์, Android Go, ChromeOS
SMS fetcher API `com.google.android.gms:play-services-auth-api-phone:18.0.1`	โทรศัพท์, แท็บเล็ต, Android Go
บล็อก Store API (รวมถึงพื้นที่เก็บข้อมูลเข้าสู่ระบบของผู้ใช้) `com.google.android.gms:play-services-auth-blockstore:16.2.0`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
Google Aware Aware API `com.google.android.gms:play-services-awareness:19.0.1`	โทรศัพท์, แท็บเล็ต, อัตโนมัติ, Android Go, ChromeOS
ชั้นเรียนสาธารณูปโภค `com.google.android.gms:play-services-base:18.2.0`	โทรศัพท์, แท็บเล็ต, Android TV, ยานยนต์, Android Go, ChromeOS, Wear OS
การทดสอบสินค้าปลอมสําหรับชั้นเรียนสาธารณูปโภค `com.google.android.gms:play-services-base-testing:16.0.0`	โทรศัพท์, แท็บเล็ต, Android TV, ยานยนต์, Android Go, ChromeOS, Wear OS
ชั้นเรียนสาธารณูปโภคเพิ่มเติม `com.google.android.gms:play-services-basement:18.2.0`	โทรศัพท์, แท็บเล็ต, Android TV, ยานยนต์, Android Go, ChromeOS, Wear OS
Google Cast `com.google.android.gms:play-services-cast:21.3.0`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
เฟรมเวิร์กแอปพลิเคชัน Google Cast (CAF) `com.google.android.gms:play-services-cast-framework:21.3.0`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
ตัวรับ Android TV `com.google.android.gms:play-services-cast-tv:21.0.0`	Android TV
เครื่องมือสแกนโค้ดของ Google `com.google.android.gms:play-services-code-scanner:16.0.0`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
สแต็กเครือข่าย Chromium (Cronet) `com.google.android.gms:play-services-cronet:18.0.1`	โทรศัพท์, แท็บเล็ต, Android TV, ยานยนต์, Android Go, ChromeOS, Wear OS
การโต้ตอบระหว่างอุปกรณ์ (DTDI) `com.google.android.gms:play-services-dtdi:16.0.0-beta01`	โทรศัพท์, แท็บเล็ต, Android Go
การตรวจสอบสิทธิ์อย่างรวดเร็วด้วย Content ID แบบออนไลน์ (FIDO) `com.google.android.gms:play-services-fido:19.0.1`	โทรศัพท์, แท็บเล็ต, Android TV, อัตโนมัติ, Android Go, ChromeOS, Wear OS รองรับในอุปกรณ์ที่ใช้ Android 7.0 (API ระดับ 24) ขึ้นไป
Google Fit API สําหรับ Android `com.google.android.gms:play-services-fitness:21.1.0`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS, Wear OS
บริการเกมของ Google Play v2 สําหรับ Android `com.google.android.gms:play-services-games-v2:17.0.0`	โทรศัพท์, แท็บเล็ต, Android TV, Android Go, ChromeOS
บริการเกมของ Google Play v2 แบบเนทีฟ C SDK สําหรับ Android `com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1`	โทรศัพท์, แท็บเล็ต, Android TV, Android Go, ChromeOS
บริการเกมของ Google Play v1 สําหรับ Android `com.google.android.gms:play-services-games:23.1.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.0.1`	โทรศัพท์, แท็บเล็ต, Android TV, Android Go, ChromeOS รองรับในอุปกรณ์ที่ใช้ Android 5.0 (API ระดับ 21) ขึ้นไป
ผู้ให้บริการ Fused Location for Android (รวมถึงการจดจํากิจกรรมและการกําหนดเขตพื้นที่เสมือน) `com.google.android.gms:play-services-location:21.0.1`	โทรศัพท์, แท็บเล็ต, Android TV, ยานยนต์, Android Go, ChromeOS, Wear OS
Google Maps SDK สําหรับ Android `com.google.android.gms:play-services-maps:18.1.0`	โทรศัพท์, แท็บเล็ต, Android TV, ยานยนต์, Android Go, ChromeOS, Wear OS
การสแกนบาร์โค้ด ML Kit `com.google.android.gms:play-services-mlkit-barcode-scanning:18.2.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-beta4`	โทรศัพท์, แท็บเล็ต, 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-text-recognition:18.0.2`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
การค้นพบและการเชื่อมต่อของอุปกรณ์ที่อยู่ใกล้เคียง `com.google.android.gms:play-services-nearby:18.5.0`	โทรศัพท์, แท็บเล็ต, Android TV, ยานยนต์, Android Go
แสดงใบอนุญาตโอเพนซอร์ส `com.google.android.gms:play-services-oss-licenses:17.0.0`	โทรศัพท์, แท็บเล็ต, Android TV, ยานยนต์, Android Go, ChromeOS รองรับในอุปกรณ์ที่ใช้ Android 5.0 (API ระดับ 21) ขึ้นไป
การตรวจสอบคุณภาพการล็อกหน้าจอ `com.google.android.gms:play-services-password-complexity:18.0.1`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS, Wear OS รองรับในอุปกรณ์ที่ใช้ Android 4.4 (API ระดับ 19) ถึง Android 9 (API ระดับ 28)
Google Pay สําหรับบัตร `com.google.android.gms:play-services-pay:16.1.0`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS รองรับในอุปกรณ์ที่ใช้ Android 5.0 (API ระดับ 20) ขึ้นไป
reCAPTCHA Enterprise สําหรับการใช้เครื่องมือแอป `com.google.android.gms:play-services-recaptcha:17.0.1`	โทรศัพท์, แท็บเล็ต, Android TV, Android Go, ChromeOS
SafetyNet API (รวมถึงเอกสารรับรองอุปกรณ์, Google Safe Browsing, reCAPTCHA และการยืนยันแอป) `com.google.android.gms:play-services-safetynet:18.0.1`	โทรศัพท์, แท็บเล็ต, Android TV, ยานยนต์, Android Go, ChromeOS
Google Tag Manager `com.google.android.gms:play-services-tagmanager:18.0.2`	โทรศัพท์, แท็บเล็ต, Android TV, Android Go, ChromeOS
Tasks API บน Android `com.google.android.gms:play-services-tasks:18.0.2`	โทรศัพท์, แท็บเล็ต, Android TV, ยานยนต์, Android Go, ChromeOS, Wear OS
TensorFlow Lite GPU Delegate API สําหรับบริการ Google Play `com.google.android.gms:play-services-tflite-gpu:16.1.0`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
TensorFlow Lite Java API สําหรับบริการ Google Play `com.google.android.gms:play-services-tflite-java:16.0.1`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
TensorFlow Lite Support API สําหรับบริการ Google Play `com.google.android.gms:play-services-tflite-support:16.0.1`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
API เทรดเครือข่าย `com.google.android.gms:play-services-threadnetwork:16.0.0`	โทรศัพท์ แท็บเล็ต
วิสัยทัศน์บนอุปกรณ์เคลื่อนที่ `com.google.android.gms:play-services-vision:20.1.3`	โทรศัพท์, แท็บเล็ต, Android Go, ChromeOS
Google Pay สําหรับการชําระเงินใน Android `com.google.android.gms:play-services-wallet:19.1.0`	โทรศัพท์, แท็บเล็ต, อัตโนมัติ, Android Go, ChromeOS, Wear OS
API ชั้นข้อมูลอุปกรณ์ที่สวมใส่ได้ `com.google.android.gms:play-services-wearable:18.0.0`	โทรศัพท์, แท็บเล็ต, Wear OS

ปลั๊กอิน Gradle

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

**ตารางที่ 2** รายการปลั๊กอิน Gradle ที่รวมอยู่ในบริการ Google Play
กรณีการใช้งานและชื่อปลั๊กอิน 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, ยานยนต์, Android Go, ChromeOS, Wear OS