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

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

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

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

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

طريقة HTTP

POST

طلب عنوان 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

GET

طلب عنوان 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

POST

طلب عنوان 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

PUT

طلب عنوان 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"