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

הגדרת Google Play Services

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

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

מכשיר 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 Services לאפליקציות ל-Android. יכול להיות שתרצו גם להוסיף את Firebase לפרויקט.
שומרים את השינויים ומסנכרנים את הפרויקט.

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

apply plugin: 'com.android.application'

...

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

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

בדיקה אם 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 מותקן במכשיר, משתמשים ב-method‏ isGooglePlayServicesAvailable().

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

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

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

**טבלה 1.** יחסי תלות של Google Play Services שצריך לכלול באפליקציות ל-Android
תרחיש לדוגמה ושם התלות	מכשירים נתמכים
‫Google Mobile Ads `com.google.android.gms:play-services-ads:25.5.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`	טלפון, טאבלט
מודעות לרשת החיפוש בהתאמה אישית (CSA) ב-AdSense לחיפוש (AFS) `com.google.android.gms:play-services-afs-native:19.1.0`	טלפון, טאבלט, ChromeOS
ערכת פיתוח תוכנה ל-Google Analytics Services ל-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: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 (כולל אחסון פרטי כניסה של משתמשים) `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.11.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.12.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, ‏ 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.3.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
‫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
גרסה 1 של Google Play Games Services ל-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 Instant `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
‫Google Maps SDK ל-Android `com.google.android.gms:play-services-maps:20.1.0`	טלפון, טאבלט, Android TV, ‏Auto, ‏Android Go, ‏ChromeOS, ‏Wear OS
Google Maps 3D SDK ל-Android `com.google.android.gms:play-services-maps3d:16.0.0`	טלפון, טאבלט
שיפור אפקטים במדיה `com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta08`	טלפון, טאבלט
איכות אודיו משופרת `com.google.android.gms:play-services-media-effect-studiosound:16.0.0-beta02`	טלפון, טאבלט
סריקת ברקודים באמצעות 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 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 text recognition `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 `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.1`	טלפון, טאבלט, 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) עד 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
Remote Gestures API `com.google.android.gms:play-services-remotegestures:16.0.0`	טלפון, טאבלט
גלישה בטוחה גרסה 5 `com.google.android.gms:play-services-safebrowsing:16.0.0`	טלפון, טאבלט, Android TV, ‏Auto, ‏Android Go, ‏ChromeOS
ממשקי API של SafetyNet (כולל גלישה בטוחה ואימות אפליקציות) `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
שירות האצה ל-Android `com.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02`	טלפון, טאבלט, Android Go, ‏ ChromeOS
TensorFlow Lite GPU Delegate API for Google Play services `com.google.android.gms:play-services-tflite-gpu:16.5.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS
TensorFlow Lite Java API ל-Google Play Services `com.google.android.gms:play-services-tflite-java:16.5.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS
TensorFlow Lite Support API for Google Play services `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 Services כולל גם כמה פלאגינים של Gradle, כמו שמוצג בטבלה הבאה. שימו לב שהלחצנים שמופיעים לפני הטבלה הקודמת לא משנים את המידע שמופיע בטבלה הזו.

**טבלה 2.** רשימת הפלאגינים של Gradle שכלולים ב-Google Play Services
תרחיש לדוגמה ושם הפלאגין של 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