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

הגדרת Google Play Services

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

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

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

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

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

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

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

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

**טבלה 1.** יחסי תלות של Google Play Services שצריך לכלול באפליקציות ל-Android
התרחיש לדוגמה ושם התלות	מכשירים נתמכים
מודעות Google לנייד `com.google.android.gms:play-services-ads:23.1.0`	טלפון, טאבלט
מזהה הפרסום ב-Android (AAID) `com.google.android.gms:play-services-ads-identifier:18.1.0`	טלפון, טאבלט, Android TV, ChromeOS
גרסה פשוטה ונוחה של מודעות Google לנייד `com.google.android.gms:play-services-ads-lite:23.1.0`	טלפון, טאבלט
מודעות בהתאמה אישית לרשת החיפוש (CSA) ב-AdSense לחיפוש (AFS) `com.google.android.gms:play-services-afs-native:19.1.0`	טלפון, טאבלט, ChromeOS
SDK של Google Analytics Services ל-Android `com.google.android.gms:play-services-analytics:18.1.0`	הוצא משימוש. במקום זאת, יש להשתמש ב-Google Analytics for Firebase.
אינדקס האפליקציות `com.google.android.gms:play-services-appindex:16.2.0`	טלפון, טאבלט, Android TV
AppSearch `com.google.android.gms:play-services-appsearch:16.0.0`	טלפון, טאבלט, 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.2.0`	טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS
SMS Retriever API `com.google.android.gms:play-services-auth-api-phone:18.1.0`	טלפון, טאבלט, Android Go
חסימת Store API (כולל אחסון של פרטי כניסה של משתמשים) `com.google.android.gms:play-services-auth-blockstore:16.2.0`	טלפון, טאבלט, Android Go, ChromeOS
Google Awareness API `com.google.android.gms:play-services-awareness:19.1.0`	טלפון, טאבלט, Auto, Android Go, ChromeOS
שיעורי עזר `com.google.android.gms:play-services-base:18.5.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.4.0`	טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast `com.google.android.gms:play-services-cast:21.5.0`	טלפון, טאבלט, Android Go, ChromeOS
Google Cast Application Framework (CAF) `com.google.android.gms:play-services-cast-framework:21.5.0`	טלפון, טאבלט, Android Go, ChromeOS
מקלטים של Android TV `com.google.android.gms:play-services-cast-tv:21.1.0`	ב-Android TV
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-beta01`	טלפון, טאבלט, Android Go
אימות מהיר של IDentity Online (FIDO) `com.google.android.gms:play-services-fido:21.1.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
גרסה 2 של Google Play Games Services ל-Android `com.google.android.gms:play-services-games-v2:20.1.0`	טלפון, טאבלט, Android TV, Android Go, ChromeOS
SDK של Google Play Games Services v2 Native C ל-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
SDK של מפות Google ל-Android `com.google.android.gms:play-services-maps:18.2.0`	טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
סריקת ברקוד ל-ML Kit `com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0`	טלפון, טאבלט, 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 `com.google.android.gms:play-services-mlkit-image-labeling:16.0.8`	טלפון, טאבלט, Android Go, ChromeOS
הוספת תוויות לתמונות בערכת ML `com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5`	טלפון, טאבלט, Android Go, ChromeOS
זיהוי השפה של ערכת ML `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 `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.0`	טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט עם ערכת ML בסינית `com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0`	טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט של ML Kit בדוונגארי `com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0`	טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט עם ערכת ML ביפנית `com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0`	טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט של ערכת ML בקוריאנית `com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0`	טלפון, טאבלט, 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) ומעלה.
בדיקת איכות של נעילת מסך `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
ממשקי SafetyNet API (כולל אימות המכשיר, גלישה בטוחה, reCAPTCHA ואימות אפליקציות) `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.1.0`	טלפון, טאבלט, Android TV, Android Go, ChromeOS
Tasks API ב-Android `com.google.android.gms:play-services-tasks:18.2.0`	טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
Acceleration Service (שירות האצה ל-Android) `com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01`	טלפון, טאבלט, Android Go, ChromeOS
TensorFlow Lite GPU Delegate API לשירותי Google Play `com.google.android.gms:play-services-tflite-gpu:16.2.0`	טלפון, טאבלט, Android Go, ChromeOS
TensorFlow Lite Java API ל-Google Play Services `com.google.android.gms:play-services-tflite-java:16.2.0-beta02`	טלפון, טאבלט, Android Go, ChromeOS
TensorFlow Lite Support API לשירותי Google Play `com.google.android.gms:play-services-tflite-support:16.1.0`	טלפון, טאבלט, Android Go, ChromeOS
Thread Network API `com.google.android.gms:play-services-threadnetwork:16.0.1`	טלפון, טאבלט
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:18.2.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