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

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

يمثّل المورد 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&quot، في هذه الأمثلة). هذا هو رقم مشروع مطوّر البرامج، وسيكون هو نفسه لجميع الطلبات التي تم إجراؤها باستخدام حساب مطوّر البرامج هذا. تأكّد من استخدام 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"