דף זה תורגם על ידי Cloud Translation API.

הגדרת Google Play Services

כדי לפתח אפליקציה באמצעות ממשקי API של Google Play Services, צריך לפעול לפי ההוראות שבדף הזה כדי להגדיר את הפרויקט עם ערכות ה-SDK הרלוונטיות, שזמינות במאגר Google Maven.

כדי לבדוק את האפליקציה כשמשתמשים בשירותי Google Play, צריך להשתמש באחד מהפתרונות הבאים:

מכשיר Android תואם עם Android בגרסה 6.0 (רמת API‏ 23) ומעלה, שמותקנת בו אפליקציית חנות Google Play.
האמולטור של Android עם AVD שמריץ את פלטפורמת Google APIs על בסיס Android 6.0 (רמת API‏ 23) ומעלה.

הצהרה על יחסי תלות ב-Google Play Services

כדי לפתח תכונות באפליקציה שמתבססות על ממשקי ה-API של Google Play Services, צריך לבצע את השלבים הבאים:

פותחים את הקובץ build.gradle בספריית המודולים של האפליקציה.

הערה: פרויקטים ב-Android Studio מכילים קובץ build.gradle ברמה העליונה וקובץ build.gradle לכל מודול. חשוב לערוך את הקובץ עבור המודול של האפליקציה. מידע נוסף על בניית פרויקט באמצעות Gradle
לכל SDK שהאפליקציה שלכם דורשת, צריך לכלול את התלות של ה-SDK הזה. בדף הזה יש קטע שבו מפורטים התלויות הנפוצות של Google Play Services באפליקציות ל-Android. אולי תרצו גם להוסיף את Firebase לפרויקט.
שומרים את השינויים ומסנכרנים את הפרויקט.

בדוגמה הבאה מוצג קובץ build.gradle שמשתמש בספריית המיקום:

apply plugin: 'com.android.application'

...

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

מדי פעם מתפרסמות גרסאות חדשות של Google Play services SDKs עם תיקוני באגים ותכונות חדשות. העדכונים האלה מפורסמים בהערות על הגרסה. אם האפליקציה שלכם משתמשת בתלות שעודכנה, אתם צריכים לעבור לגרסה העדכנית בתלות של האפליקציה כדי ליהנות מהתיקונים האלה.

איך בודקים אם שירותי Google Play מותקנים

כפי שמתואר בסקירה כללית של Google Play Services ,‏ Google Play Services מתעדכנת באופן אוטומטי ב-Android בגרסה 6.0 (רמת API‏ 23) ומעלה דרך אפליקציית חנות Google Play. עם זאת, במכשירים שאין בהם את חנות Google Play,‏ Google Play Services לא מותקנת. אם האפליקציה שלכם פועלת במכשירים ללא שירותי Google Play, תמיד צריך לבדוק אם שירותי Google Play מותקנים לפני שמנסים להשתמש ב-Google APIs או להפעיל תכונות שדורשות אותם.

כדי לבדוק אם Google Play Services מותקן במכשיר, משתמשים בשיטה isGooglePlayServicesAvailable().

כדי להתחיל להתחבר אל Google Play Services או כדי ללמוד איך לזהות אם הגרסה המותקנת של Google Play Services תומכת בממשק API ספציפי, אפשר לקרוא את המדריך בנושא גישה לממשקי Google API.

יחסי תלות של Google Play Services

בטבלה הבאה מפורטים התלות של Google Play Services שאפשר לכלול באפליקציית Android. אפשר לסנן את הרשימה לפי סוג המכשיר על ידי בחירה באחד מהלחצנים, ואפשר לחפש תרחיש שימוש ספציפי או שם של תלות על ידי הזנת טקסט בתיבה שמופיעה אחרי הלחצנים.

**טבלה 1.** תלויות של שירותי Google Play שצריך לכלול באפליקציות ל-Android
תרחיש שימוש ושם התלות	מכשירים נתמכים
‫Google Mobile Ads `com.google.android.gms:play-services-ads:24.4.0`	טלפון, טאבלט
מזהה הפרסום ב-Android ‏ (AAID) `com.google.android.gms:play-services-ads-identifier:18.2.0`	טלפון, טאבלט, Android TV, ‏ ChromeOS
גרסה קלה של Google Mobile Ads `com.google.android.gms:play-services-ads-lite:24.3.0`	טלפון, טאבלט
מודעות בהתאמה אישית לחיפוש (CSA) ב-AdSense לחיפוש (AFS) `com.google.android.gms:play-services-afs-native:19.1.0`	טלפון, טאבלט, ChromeOS
‫Google Analytics Services SDK ל-Android `com.google.android.gms:play-services-analytics:18.1.1`	הוצא משימוש. במקום זאת, צריך להשתמש ב-Google Analytics for 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 ל-Android `com.google.android.gms:play-services-auth:21.3.0`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go, ‏ ChromeOS
‫SMS Retriever API `com.google.android.gms:play-services-auth-api-phone:18.2.0`	טלפון, טאבלט, Android Go
Block Store API (includes user credential storage) `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`	טלפון, טאבלט, Auto, ‏ Android Go, ‏ ChromeOS
Utility classes `com.google.android.gms:play-services-base:18.7.2`	טלפון, טאבלט, 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.7.1`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go, ‏ ChromeOS, ‏ Wear OS
Camera Low Light Boost `com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta03`	טלפון, טאבלט
‫Google Cast `com.google.android.gms:play-services-cast:22.1.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS
Google Cast Application Framework (CAF) `com.google.android.gms:play-services-cast-framework:22.1.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS
Google Code Scanner `com.google.android.gms:play-services-code-scanner:16.1.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS
Chromium network stack (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
אימות FIDO ‏ (Fast IDentity Online) `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 for Android ו-Recording API on mobile (לנתוני כושר של משתמשים) `com.google.android.gms:play-services-fitness:21.2.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS, ‏ Wear OS
‫Google Play Games Services v2 for Android `com.google.android.gms:play-services-games-v2:21.0.0`	טלפון, טאבלט, Android TV, ‏ Android Go, ‏ ChromeOS
‫Google Play Games Services v2 Native C SDK for Android `com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1`	טלפון, טאבלט, Android TV, ‏ Android Go, ‏ ChromeOS
‫Google Play Games Services v1 for 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 ללא התקנה `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.2.0`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go, ‏ ChromeOS, ‏ Wear OS
‫Google Maps 3D SDK ל-Android `com.google.android.gms:play-services-maps3d:0.0.2`	טלפון, טאבלט
‫ML Kit barcode scanning `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 image labeling `com.google.android.gms:play-services-mlkit-image-labeling:16.0.8`	טלפון, טאבלט, Android Go, ‏ ChromeOS
‫ML Kit image labeling custom `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 text recognition for Devanagari `com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1`	טלפון, טאבלט, Android Go, ‏ ChromeOS
‫ML Kit text recognition for Japanese `com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1`	טלפון, טאבלט, Android Go, ‏ ChromeOS
ML Kit text recognition for Korean `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.2.1`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go, ‏ ChromeOS נתמך במכשירים עם Android בגרסה 5.0 (רמת API‏ 21) ומעלה.
ספריות לגישה פרוגרמטית (PAL) `com.google.android.gms:play-services-pal:22.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) עד גרסה 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 (כולל גלישה בטוחה ואימות אפליקציות) `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.3.2`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go, ‏ ChromeOS, ‏ Wear OS
Acceleration Service for Android `com.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01`	טלפון, טאבלט, Android Go, ‏ ChromeOS
TensorFlow Lite GPU Delegate API for Google Play services `com.google.android.gms:play-services-tflite-gpu:16.4.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS
‫TensorFlow Lite Java API for Google Play services `com.google.android.gms:play-services-tflite-java:16.4.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS
TensorFlow Lite Support API for Google Play services `com.google.android.gms:play-services-tflite-support:16.4.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:19.4.0`	טלפון, טאבלט, Auto, ‏ Android Go, ‏ ChromeOS, ‏ Wear OS
‫Wearable Data Layer API `com.google.android.gms:play-services-wearable:19.0.0`	טלפון, טאבלט, Wear OS

פלאגינים של Gradle

‫Google Play Services כולל גם כמה פלאגינים של 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, ‏ Auto, ‏ Android Go, ‏ ChromeOS, ‏ Wear OS