سيتم إيقاف واجهات برمجة تطبيقات Google Fit نهائيًا في عام 2026، بما في ذلك واجهة برمجة التطبيقات Google Fit REST API. اعتبارًا من 1 أيار (مايو) 2024، لن يتمكّن المطوّرون من الاشتراك لاستخدام واجهات برمجة التطبيقات هذه.
للحصول على تعليمات حول واجهة برمجة التطبيقات أو المنصة التي تريد نقل البيانات إليها، يُرجى الانتقال إلى دليل نقل البيانات في Health Connect. للاطّلاع على مقارنة بين Health Connect وGoogle Fit API وFitbit Web API، يُرجى الانتقال إلى دليل مقارنة Health Connect.
مزيد من المعلومات حول Health Connect وكيفية الدمج مع واجهة برمجة التطبيقات
تحديد مصدر البيانات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لكل نقطة بيانات في Google Fit مصدر بيانات مرتبط بها. تحتوي مصادر البيانات على معلومات لتحديد التطبيق أو الجهاز الذي يجمع البيانات أو يحولها.
تتيح لك واجهة برمجة تطبيقات REST تحديد بيانات اللياقة البدنية التي يتم إدراجها في التطبيق.
على سبيل المثال، قد يحتاج أحد التطبيقات التي يحلل مجموعة متنوعة من البيانات من سجل اللياقة البدنية للمستخدم إلى تزويد المستخدمين بقائمة بجلسات اللياقة البدنية المضمنة في التحليل، إلى جانب معلومات عن التطبيق الذي تم إدراجه في كل جلسة.
تتيح لك REST API أيضًا ربط البيانات التي تدرجها في مخزن بيانات اللياقة البدنية بتطبيقك.
تحديد التطبيق الذي تم إدراجه من البيانات
للحصول على اسم حزمة تطبيق Android الذي أدرجت جلسة أو اسم تطبيق REST الذي أدرج جلسة:
- استرجع الجلسة.
- اطّلِع على السمة
session.application.packageName أو
session.application.name.
للحصول على اسم حزمة تطبيق Android أو
اسم تطبيق REST الذي أدرجت مجموعة بيانات:
- استرجع مجموعة البيانات.
- يمكنك استرداد مصدر البيانات من خلال الاطّلاع على
السمة
dataset.dataSourceId.
- اطّلِع على السمة
dataSources.application.packageName
أو dataSources.application.name.
تحتوي السمة application على الحقول التالية:
name- اسم التطبيق:
packageName- اسم حزمة تطبيق Android
detailsUrl- (اختياري) معرِّف الموارد المنتظم (URI) للربط بالتطبيق.
عند إدراج جميع الجلسات المتاحة لفاصل زمني في تطبيقك، يمكنك استخدام هذه المعلومات لإطلاع المستخدمين على التطبيق الذي تم إدراجه في كل جلسة.
لإحالة البيانات التي تدرجها في متجر اللياقة البدنية إلى تطبيقك، تأكَّد مما يلي:
ويمكن للتطبيقات التي لديها إمكانية الوصول إلى البيانات التي أدرجتها استخدام هذه المعلومات لربط تلك البيانات بتطبيقك.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eEvery data point in Google Fit is linked to a data source, which identifies the source app or device.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Fit REST API allows you to identify the app that inserted specific fitness data, like sessions or datasets.\u003c/p\u003e\n"],["\u003cp\u003eYou can attribute data you insert into Google Fit to your application by including application details when creating data sources.\u003c/p\u003e\n"],["\u003cp\u003eThis attribution allows other apps to correctly identify your application as the source of the data.\u003c/p\u003e\n"]]],[],null,["# Data Attribution\n\nEvery data point in Google Fit has an associated data source. Data sources contain\ninformation to identify the app or the device that collects or transforms the data.\n\nThe REST API lets you determine which app inserted fitness data.\nFor example, an app that analyzes a variety of data from the user's fitness history may\nwant to present users with the list of fitness sessions included in the analysis, along with\ninformation about which app inserted each session.\n\nThe REST API also lets you associate data that you insert in the fitness store with your\napplication.\n\nDetermine which application inserted data\n-----------------------------------------\n\nTo obtain the package name of the Android application that inserted a session or\nthe name of the REST application that inserted a session:\n\n1. Retrieve the session.\n2. Read the [`session.application.packageName`](/fit/rest/v1/reference/users/sessions/list#session.application.packageName) or [`session.application.name`](/fit/rest/v1/reference/users/sessions/list#session.application.name) property.\n\nTo obtain the package name of the Android application or\nthe name of the REST application that inserted a dataset:\n\n1. Retrieve the dataset.\n2. Retrieve the data source by reading the [`dataset.dataSourceId`](/fit/rest/v1/reference/users/dataSources/datasets#dataSourceId) property.\n3. Read the [`dataSources.application.packageName`](/fit/rest/v1/reference/users/dataSources#application.packageName) or [`dataSources.application.name`](/fit/rest/v1/reference/users/dataSources#application.name) property.\n\nThe `application` property contains these fields:\n\n`name`\n: The name of the application.\n\n`packageName`\n: The package name of the Android application.\n\n`detailsUrl`\n: (Optional) A URI to link to the application.\n\nWhen you list all available sessions for a time interval in your application, you can\nuse this information to show your users which app inserted each session.\n\nProvide information about your application\n------------------------------------------\n\nTo attribute data you insert into the fitness store to your application, ensure that:\n\n- You add your application details to the [`dataSources.application`](/fit/rest/v1/reference/users/dataSources#application) property when creating data sources.\n- You specify the correct [`datasets.dataSourceId`](/fit/rest/v1/reference/users/dataSources/datasets) for your data source when adding points to datasets.\n\nApplications accessing data you inserted can use this information to attribute that data to your\napplication."]]
