דף זה תורגם על ידי Cloud Translation API.

יצירה של לקוח כושר API

הדוגמה הזו מראה איך ליצור לקוח API של כושר.

יוצרים את לקוח ה-API באופן הבא:

יוצרים מופע ב-FitnessOptions, מצהירים על סוגי הנתונים ואת סוג הגישה (קריאה ו/או כתיבה) שהאפליקציה צריכה:

טיפ: מומלץ לבחור סוגי נתונים באופן אחראי. אין לבקש כל סוג נתונים למקרה שהאפליקציה תצטרך אותו. הסוגים שצוינו קובעים את ההיקפים שבהם המשתמשים מתבקשים להעניק הרשאה. צריך לבקש רק את סוגי הנתונים שהאפליקציה צריכה, כך שיש סיכוי גבוה יותר שהמשתמשים יקבלו גישה. המשתמשים מעניקים גישה קלה יותר להיקפים מוגבלים ומתוארים בבירור.
```
val fitnessOptions = FitnessOptions.builder()
    .addDataType(DataType.TYPE_STEP_COUNT_DELTA, FitnessOptions.ACCESS_READ)
    .addDataType(DataType.AGGREGATE_STEP_COUNT_DELTA, FitnessOptions.ACCESS_READ)
    .build()
```

הצגת מופע של האובייקט Account לשימוש עם ה-API:

val account = GoogleSignIn.getAccountForExtension(this, fitnessOptions)

בודקים אם המשתמש נתן בעבר את הרשאת הגישה הנדרשת לנתונים, ואם לא, מתחילים את תהליך ההרשאה:

if (!GoogleSignIn.hasPermissions(account, fitnessOptions)) {
    GoogleSignIn.requestPermissions(
        this, // your activity
        GOOGLE_FIT_PERMISSIONS_REQUEST_CODE, // e.g. 1
        account,
        fitnessOptions)
} else {
    accessGoogleFit()
}

אם נדרש תהליך הרשאה, צריך לטפל בתגובה של המשתמש:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    when (resultCode) {
        Activity.RESULT_OK -> when (requestCode) {
            GOOGLE_FIT_PERMISSIONS_REQUEST_CODE -> accessGoogleFit()
            else -> {
                // Result wasn't from Google Fit
            }
        }
        else -> {
            // Permission not granted
        }
    }
}

לאחר שהמשתמש נתן הרשאת גישה לנתונים הנדרשים, יש ליצור לקוח כושר (למשל, HistoryClient כדי לקרוא ו/או לכתוב נתוני כושר היסטוריים) על סמך האפליקציה והצרכים שלך:

private fun accessGoogleFit() {
    val end = LocalDateTime.now()
    val start = end.minusYears(1)
    val endSeconds = end.atZone(ZoneId.systemDefault()).toEpochSecond()
    val startSeconds = start.atZone(ZoneId.systemDefault()).toEpochSecond()

    val readRequest = DataReadRequest.Builder()
        .aggregate(DataType.AGGREGATE_STEP_COUNT_DELTA)
        .setTimeRange(startSeconds, endSeconds, TimeUnit.SECONDS)
        .bucketByTime(1, TimeUnit.DAYS)
        .build()
    val account = GoogleSignIn.getAccountForExtension(this, fitnessOptions)
    Fitness.getHistoryClient(this, account)
        .readData(readRequest)
        .addOnSuccessListener({ response ->
            // Use response data here
            Log.i(TAG, "OnSuccess()")
        })
        .addOnFailureListener({ e -> Log.d(TAG, "OnFailure()", e) })
}