إدارة مصادر البيانات

تتيح لك واجهة برمجة التطبيقات Fitness REST إنشاء مصادر البيانات والحصول عليها وتعديلها. يمثل مصدر البيانات مصدرًا فريدًا لبيانات جهاز الاستشعار. تستخدم مصادر البيانات لإدراج بيانات اللياقة البدنية في اللياقة البدنية ويمكنك استرداد بيانات اللياقة البدنية المدرجة من خلال مصدر بيانات معين.

يتم تمثيل مصادر البيانات من خلال Users.dataSources المصدر.

إنشاء مصدر بيانات

يوضّح هذا المثال كيفية إنشاء مصدر بيانات جديد باسم "MyDataSource" توفّر إضافات في عدد الخطوات

طريقة HTTP
نشر
طلب عنوان URL
https://www.googleapis.com/fitness/v1/users/me/dataSources
نص الطلب
{
  "dataStreamName": "MyDataSource",
  "type": "derived",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "Foo Example App",
    "version": "1"
  },
  "dataType": {
    "field": [
      {
        "name": "steps",
        "format": "integer"
      }
    ],
    "name": "com.google.step_count.delta"
  },
  "device": {
    "manufacturer": "Example Manufacturer",
    "model": "ExampleTablet",
    "type": "tablet",
    "uid": "1000001",
    "version": "1.0"
  }
}
الرد

إذا تم إنشاء مصدر البيانات بنجاح، تكون حالة الردّ 200 OK. الرمز. يحتوي نص الاستجابة على تمثيل JSON لمصدر البيانات، بما في ذلك datasource.dataStreamId الموقع الذي يمكنك استخدامه كرقم تعريف مصدر البيانات للطلبات اللاحقة.

أمر Curl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X POST \
--header "Content-Type: application/json;encoding=utf-8" -d @createds.json \
"https://www.googleapis.com/fitness/v1/users/me/dataSources"

الحصول على مصدر بيانات معيّن

يوضّح هذا المثال كيفية استرداد مصدر البيانات ("MyDataSource") الذي قمت بإنشائه في المثال السابق. عند إنشاء مصدر بيانات جديد، تتضمن dataStreamId معرّفًا فريدًا (يظهر باسم "1234567890" في هذه الأمثلة). هذا هو رقم مشروع المطور الخاص بك، وسيكون هو نفسه مع جميع الطلبات المقدمة باستخدام حساب المطوّر المحدد. تأكد من استخدام dataStreamId من مصدر البيانات الذي أنشأته.

طريقة HTTP
تنزيل
طلب عنوان URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
نص الطلب
ما مِن قيمة محدّدة
الرد
إذا كان مصدر البيانات متوفرًا، تكون الاستجابة رمز حالة 200 OK. يحتوي نص الاستجابة على تمثيل JSON لمصدر البيانات.
أمر Curl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X GET 

--header "Content-Type: application/json;encoding=utf-8" 

"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"

الحصول على بيانات مجمّعة

يوضح هذا المثال كيفية إجراء طلب بحث في مصدر بيانات محدّد البيانات، في هذه الحالة estimated_steps، وهو مصدر البيانات المستخدَم لعرض عدد الخطوات في تطبيق Google Fit. يُرجى العلم أنّ الطوابع الزمنية في طلب JSON الجسم بالمللي ثانية.

طريقة HTTP
نشر
طلب عنوان URL
https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate
نص الطلب
{
  "aggregateBy": [{
    "dataSourceId":
      "derived:com.google.step_count.delta:com.google.android.gms:estimated_steps"
  }],
  "bucketByTime": { "durationMillis": 86400000 },
  "startTimeMillis": 1454284800000,
  "endTimeMillis": 1455062400000
}
الرد

إذا كانت مصادر البيانات متوفّرة، يكون الردّ هو رمز حالة 200 OK. تشير رسالة الأشكال البيانية يحتوي نص الاستجابة على تمثيل JSON لمصدر البيانات.

أمر Curl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X POST \
--header "Content-Type: application/json;encoding=utf-8" -d @aggregate.json \
"https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate"

تعديل مصدر بيانات

يوضح هذا المثال كيفية تعديل الاسم وإصدار الجهاز لإحدى البيانات. المصدر.

طريقة HTTP
إضافة
طلب عنوان URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
نص الطلب
{
  "dataStreamId": "derived:com.google.step_count.delta:1234567890:Example Manufacturer:ExampleTablet:1000001:MyDataSource",
  "dataStreamName": "MyDataSource",
  "type": "derived",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "Foo Example App",
    "version": "1"
  },
  "dataType": {
    "field": [
      {
        "name": "steps",
        "format": "integer"
      }
    ],
    "name": "com.google.step_count.delta"
  },
  "device": {
    "manufacturer": "Example Manufacturer",
    "model": "ExampleTablet",
    "type": "tablet",
    "uid": "1000001",
    "version": "2.0"
  }
}
الرد

إذا تم تعديل مصدر البيانات بنجاح، تكون حالة الردّ "200 OK" الرمز. يحتوي نص الاستجابة على تمثيل JSON لمصدر البيانات.

أمر Curl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X PUT \
--header "Content-Type: application/json;encoding=utf-8" -d @updateds.json \
"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"

حذف مصدر بيانات

يوضح هذا المثال كيفية حذف مصدر بيانات.

طريقة HTTP
حذف
طلب عنوان URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
نص الطلب
ما مِن قيمة محدّدة
الرد
إذا تم حذف مصدر البيانات بنجاح، يكون الردّ بالحالة 200 OK الرمز. يحتوي نص الاستجابة على تمثيل JSON لمصدر البيانات الذي .
أمر Curl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X DELETE \
--header "Content-Type: application/json;encoding=utf-8" \
"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"