تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

إنشاء عميل Fitness 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 لاستخدامه مع واجهة برمجة التطبيقات:
```
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) })
}