‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

הגדרת Google Play Services

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

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

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

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

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

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

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

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

apply plugin: 'com.android.application'

...

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

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

איך בודקים אם Google Play Services מותקן

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

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

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

יחסי תלות ב-Google Play Services

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

**טבלה 1.** תלויות בשירותי Google Play שיש לכלול באפליקציות אנדרואיד
מקרה שימוש ושם תלות	מכשירים נתמכים
‫Google Mobile Ads `com.google.android.gms:play-services-ads:25.4.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:25.0.0`	טלפון, טאבלט
AdSense לחיפוש (AFS) מודעות לרשת החיפוש בהתאמה אישית (CSA) `com.google.android.gms:play-services-afs-native:19.1.0`	טלפון, טאבלט, ChromeOS
ערכת פיתוח תוכנה ל-Google Analytics Services לאנדרואיד `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
כניסה לגוגל לאנדרואיד `com.google.android.gms:play-services-auth:22.0.0`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go, ‏ ChromeOS
‫SMS Retriever API `com.google.android.gms:play-services-auth-api-phone:18.3.1`	טלפון, טאבלט, Android Go
Block Store API (includes user credential storage) `com.google.android.gms:play-services-auth-blockstore:16.4.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS
ממשק ה-API של גוגל למודעות `com.google.android.gms:play-services-awareness:20.0.0`	טלפון, טאבלט, Auto, ‏ Android Go, ‏ ChromeOS
Utility classes `com.google.android.gms:play-services-base:18.10.1`	טלפון, טאבלט, 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.11.0`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go, ‏ ChromeOS, ‏ Wear OS
שיפור סרטונים בתאורה נמוכה במצלמה `com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta09`	טלפון, טאבלט
‫Google Cast `com.google.android.gms:play-services-cast:22.3.1`	טלפון, טאבלט, Android Go, מערכת הפעלה כרום
‫Google Cast Application Framework ‏ (CAF) `com.google.android.gms:play-services-cast-framework:22.3.1`	טלפון, טאבלט, Android Go, מערכת הפעלה כרום
Google Code Scanner `com.google.android.gms:play-services-code-scanner:16.1.0`	טלפון, טאבלט, Android Go, מערכת הפעלה כרום
‫Chromium network stack (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`	טלפון, טאבלט
אימות FIDO ‏ (Fast IDentity Online) `com.google.android.gms:play-services-fido:21.3.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.3.0`	טלפון, טאבלט, אנדרואיד גו, כרום OS, מערכת הפעלה Wear OS
‫Fraud Protect `com.google.android.gms:play-services-fraudprotect:16.0.1`	טלפון, טאבלט, Android Go
‫Google Play Games Services v2 ל-Android `com.google.android.gms:play-services-games-v2:22.1.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:25.0.0`	הוצא משימוש. במקום זאת, צריך להשתמש בGoogle Play Games Services v2.
Matter API `com.google.android.gms:play-services-home:16.0.0`	טלפון, טאבלט
Google Play ללא התקנה `com.google.android.gms:play-services-instantapps:18.2.0`	הוצא משימוש. מידע נוסף זמין במאמר בנושא Google Play ללא התקנה.
שירותי מיקום ל-Android `com.google.android.gms:play-services-location:21.4.0`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go, ‏ ChromeOS, ‏ Wear OS
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.2`	טלפון, טאבלט
שיפור אפקטים של מדיה `com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta08`	טלפון, טאבלט
סריקת ברקוד של ML Kit `com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1`	טלפון, טאבלט, Android Go, מערכת הפעלה כרום
סורק מסמכים של ערכת ML Kit `com.google.android.gms:play-services-mlkit-document-scanner:16.0.0`	טלפון, טאבלט, Android Go, מערכת הפעלה כרום
זיהוי פנים ב-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, מערכת הפעלה כרום
‫ML Kit image labeling custom `com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5`	טלפון, טאבלט, Android Go, מערכת הפעלה כרום
זיהוי שפה ב-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, מערכת הפעלה כרום
פילוח נושאים ב-ML Kit `com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1`	טלפון, טאבלט, Android Go, מערכת הפעלה כרום
זיהוי טקסט באמצעות ML Kit `com.google.android.gms:play-services-mlkit-text-recognition:19.0.1`	טלפון, טאבלט, Android Go, מערכת הפעלה כרום
‫ML Kit text recognition for Chinese `com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1`	טלפון, טאבלט, Android Go, מערכת הפעלה כרום
‫ML Kit text recognition for Devanagari `com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1`	טלפון, טאבלט, Android Go, מערכת הפעלה כרום
‫ML Kit text recognition for Japanese `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.5.0`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go
הצגת רישיונות קוד פתוח `com.google.android.gms:play-services-oss-licenses:17.5.2`	טלפון, טאבלט, 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) עד גרסה 9 (רמת API‏ 28).
‫Google Wallet (לשעבר Google Pay for Passes) `com.google.android.gms:play-services-pay:16.5.0`	טלפון, טאבלט, Android Go, מערכת הפעלה Chrome נתמך במכשירים המריצים Android 5.0 (רמת API 20) ומעלה.
reCAPTCHA Enterprise עבור כלי עזר לאפליקציות `com.google.android.gms:play-services-recaptcha:17.1.0`	טלפון, טאבלט, Android TV, Android Go, מערכת הפעלה ChromeOS
Remote Gestures API `com.google.android.gms:play-services-remotegestures:16.0.0`	טלפון, טאבלט
‫גלישה בטוחה v5 `com.google.android.gms:play-services-safebrowsing:16.0.0`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ 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.4.1`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go, ‏ ChromeOS, ‏ Wear OS
Acceleration Service for Android `com.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02`	טלפון, טאבלט, Android Go, מערכת הפעלה כרום
ממשק API של TensorFlow Lite GPU Delegate עבור שירותי Google Play `com.google.android.gms:play-services-tflite-gpu:16.5.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS
ממשק API של TensorFlow Lite Java עבור שירותי Google Play `com.google.android.gms:play-services-tflite-java:16.5.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS
ממשק API לתמיכה של TensorFlow Lite עבור שירותי Google Play `com.google.android.gms:play-services-tflite-support:16.5.0`	טלפון, טאבלט, Android Go, מערכת הפעלה כרום
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, מערכת הפעלה כרום
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 Services כוללים גם מספר תוספים של Gradle, כפי שמוצג בטבלה הבאה. שימו לב שהלחצנים שמופיעים לפני הטבלה הקודמת לא משנים את המידע שמופיע בטבלה הזו.

**טבלה 2.** רשימת הפלאגינים של Gradle שכלולים בשירותי Google Play
מקרה שימוש ושם תוסף Gradle	מכשירים נתמכים
הצגת רישיונות קוד פתוח `com.google.android.gms:oss-licenses-plugin:0.13.0`	טלפון, טאבלט, ChromeOS
בדיקת גרסאות קפדנית `com.google.android.gms:strict-version-matcher-plugin:1.2.4`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go, ‏ ChromeOS, ‏ Wear OS