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

הגדרת Google Play Services

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

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

מכשיר 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'
}

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

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

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

**טבלה 1.** יחסי התלות של Google Play Services שצריך לכלול באפליקציות ל-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 ל-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 (כולל אחסון פרטי כניסה של משתמשים) `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`	טלפון, טאבלט, רכב, Android Go, ‏ ChromeOS
כיתות שירות `com.google.android.gms:play-services-base:18.7.0`	טלפון, טאבלט, 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.0`	טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go, ‏ ChromeOS, ‏ Wear OS
שיפור התמונה בתאורה נמוכה במצלמה `com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta01`	טלפון, טאבלט
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 לרשת (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
אימות 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.2.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS, ‏ Wear OS
Google Play Games Services v2 ל-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 גרסה 1 ל-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 `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 `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 עבור דוונאגרי `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.1.0`	טלפון, טאבלט, 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) עד 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
ממשקי 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.3.0`	טלפון, טאבלט, 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 ל-Google Play Services `com.google.android.gms:play-services-tflite-gpu:16.4.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS
TensorFlow Lite Java API ל-Google Play Services `com.google.android.gms:play-services-tflite-java:16.4.0`	טלפון, טאבלט, Android Go, ‏ ChromeOS
TensorFlow Lite Support API ל-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`	טלפון, טאבלט, רכב, 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`	טלפון, טאבלט, רכב, 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 Services
תרחיש לדוגמה ושם הפלאגין של 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