מחזירה מערך נתונים שמכיל את כל נקודות הנתונים שזמני ההתחלה והסיום שלהן חופפים לטווח שצוין של זמן ההתחלה המינימלי וזמן הסיום המקסימלי של מערך הנתונים. באופן ספציפי, כל נקודה על הגרף ששעת ההתחלה שלה קטנה משעת הסיום של מערך הנתונים או שווה לה, ושעת הסיום שלה גדולה משעת ההתחלה של מערך הנתונים או שווה לה. רוצים לנסות עכשיו?
בקשה
בקשת HTTP
GET https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
פרמטרים
| שם הפרמטר | ערך | תיאור |
|---|---|---|
| פרמטרים של נתיב | ||
dataSourceId |
string |
מזהה מקור הנתונים של מקור הנתונים שיצר את מערך הנתונים. |
datasetId |
string |
מזהה של מערך נתונים שמורכב מזמן ההתחלה המינימלי של נקודת הנתונים ומזמן הסיום המקסימלי של נקודת הנתונים, מיוצג כננו-שניות מראשית הזמן (epoch). הפורמט של המזהה הוא: "startTime-endTime", כאשר startTime ו-endTime הם מספרים שלמים של 64 ביט. |
userId |
string |
מאחזרים מערך נתונים עבור האדם שזוהה. משתמשים ב-me כדי לציין את המשתמש המאומת. בשלב הזה יש תמיכה רק ב-me.
|
| פרמטרים אופציונליים של שאילתות | ||
limit |
integer |
אם מציינים את הפרמטר הזה, מערך הנתונים לא יכלול יותר ממספר זה של נקודות נתונים. אם יש יותר נקודות נתונים במערך הנתונים, NextPageToken יוגדר בתגובה של מערך הנתונים. המגבלה תחול בסוף טווח הזמן. כלומר, אם השדה pageToken חסר, יוחזרו limit הנקודות האחרונות על הגרף. |
pageToken |
string |
אסימון ההמשך, שמשמש לדפדוף במערכי נתונים גדולים.
כדי לקבל את הדף הבא במערך נתונים, צריך להגדיר את הפרמטר הזה לערך nextPageToken מהתגובה הקודמת. כל קריאה נוספת תייצר מערך נתונים חלקי עם חותמות זמן לסיום של נקודות הנתונים, שהן קטנות באופן משמעותי מאלה שצוינו בתגובה החלקית הקודמת.
|
אישור
בקשה זו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים:
| היקף |
|---|
https://www.googleapis.com/auth/fitness.activity.read |
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.read |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.read |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.read |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.read |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.read |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.read |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.read |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.read |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
למידע נוסף, עיין בדף אימות והרשאה.
גוף הבקשה
אל תספקו גוף הבקשה בשיטה הזו.
תשובה
אם הפעולה בוצעה בהצלחה, השיטה הזו מחזירה משאב Users.dataSources.datasets בגוף התשובה.
רוצה לנסות?
צריך להשתמש ב-APIs Explorer שבהמשך כדי לקרוא לשיטה הזו בנתונים בזמן אמת ולראות את התגובה.