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

הגדרת Google Play Services

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

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

מכשיר Android תואם עם Android 6.0 (API רמה 23) ואילך והוא כולל את אפליקציית חנות Google Play מותקנת.
האמולטור של Android עם שרת AVD שמפעיל את ממשקי ה-API של Google שמבוססת על 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 נפוצים של אפליקציות ל-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. לעומת זאת, במכשירי Android בלי Google Play שירותי Google Play לא מותקנים בחנות. אם האפליקציה פועלת במכשירים בלי Google Play Services, כדאי לבדוק אם Google Play מותקנים במכשיר לפני שמנסים להשתמש ב-Google APIs, או להפעיל תכונות באפליקציה שמחייבות פעולה של 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.2.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.2.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.3.1`	טלפון, טאבלט, 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
Google Play Games Services גרסה 2 ל-Android `com.google.android.gms:play-services-games-v2:20.1.2`	טלפון, טאבלט, Android TV, Android Go, ChromeOS
Google Play Games Services v2 Native C SDK ל-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:19.0.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 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 `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 Kit ביפנית `com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0`	טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט של ML Kit בקוריאנית `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 הענקת 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`	טלפון, טאבלט
צפייה בנייד `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
API של שכבת נתונים 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