Google API'lerine erişme

Google ile Oturum Açma veya Makine Öğrenimi Kiti gibi Google Play hizmetlerinde öncelikle API istemci nesnesinin bir örneğini oluşturun. Bu nesneler otomatik olarak yönetilir Google Play Hizmetleri bağlantısı. Bağlantı mevcut olduğunda her API client nesnesi, istekleri sırayla yürütür. Aksi takdirde, istemci nesnesi sıraya alınır talep etmiş olursunuz. Belge aksini belirtmedikçe istemci nesneleri ucuzdur anlamak; çağırmak istediğiniz her seferde yeni API istemcileri API yöntemlerinden birini seçin.

Bu kılavuzda, kullanmayan hizmetlere nasıl erişebileceğiniz de dahil olmak üzere Yetkilendirme gerektiren ve yapılmasını gerektiren yetkilendirme başlıklı makaleyi inceleyin.

Başlayın

Başlamak için uygulama projenize gerekli araçları ve bağımlılıkları Google Play'i nasıl kuracağınıza ilişkin kılavuzda hizmet.

Yetkilendirme gerekli olmadığında erişim

API yetkilendirmesi gerektirmeyen bir hizmete erişmek için öğesinin istemci nesnesine geçişini yapmak için Context veya geçerli Activity. Herhangi bir API çağrısı yürütülmeden önce kullanıcılardan Google Play'i yeni sürüme geçirmeleri istenir hizmetleri sunmalısınız.

Örneğin, Çok Kaynaklı Konumu kullanarak cihazın bilinen son konumunu öğrenmek için Sağlayıcı olarak Android için kullanıyorsanız aşağıdaki kod snippet'inde gösterilen mantığı ekleyin:

Kotlin

// Code required for requesting location permissions omitted for brevity.
val client = LocationServices.getFusedLocationProviderClient(this)

// Get the last known location. In some rare situations, this can be null.
client.lastLocation.addOnSuccessListener { location : Location? ->
    location?.let {
        // Logic to handle location object.
    }
}

Java

// Code required for requesting location permissions omitted for brevity.
FusedLocationProviderClient client =
        LocationServices.getFusedLocationProviderClient(this);

// Get the last known location. In some rare situations, this can be null.
client.getLastLocation()
        .addOnSuccessListener(this, location -> {
            if (location != null) {
                // Logic to handle location object.
            }
        });

Yetkilendirme gerektiğinde erişim

Kullanıcı yetkilendirmesi gerektiren bir hizmete erişmek için aşağıdaki adımları uygulayın için şu adımları izleyin:

1. Kullanıcının oturum açmasını sağlayın.
2. Hizmetin gerektirdiği kapsamlara erişim izni isteyin.
3. Hizmetin istemci nesnesinin bir örneğini alın ve GoogleSignInAccount yanı sıra bir Context veya Activity nesnesini tanımlayın.

Aşağıdaki örnekte, Google Fit API'si. Benzer bir uygulamayı tam bir proje bağlamında görmek için ana etkinliğini BasicHistoryApiKotlin uygulamasını kullanın.

Kotlin

class FitFragment : Fragment() {
    private val fitnessOptions: FitnessOptions by lazy {
        FitnessOptions.builder()
            .addDataType(DataType.TYPE_STEP_COUNT_CUMULATIVE)
            .addDataType(DataType.TYPE_STEP_COUNT_DELTA)
            .build()
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        fitSignIn()
    }

    /*
     * Checks whether the user is signed in. If so, executes the specified
     * function. If the user is not signed in, initiates the sign-in flow,
     * specifying the function to execute after the user signs in.
     */
    private fun fitSignIn() {
        if (oAuthPermissionsApproved()) {
            readDailySteps()
        } else {
            GoogleSignIn.requestPermissions(
                this,
                SIGN_IN_REQUEST_CODE,
                getGoogleAccount(),
                fitnessOptions
            )
        }
    }

    private fun oAuthPermissionsApproved() =
        GoogleSignIn.hasPermissions(getGoogleAccount(), fitnessOptions)

    /*
     * Gets a Google account for use in creating the fitness client. This is
     * achieved by either using the last signed-in account, or if necessary,
     * prompting the user to sign in. It's better to use the
     * getAccountForExtension() method instead of the getLastSignedInAccount()
     * method because the latter can return null if there has been no sign in
     * before.
     */
    private fun getGoogleAccount(): GoogleSignInAccount =
        GoogleSignIn.getAccountForExtension(requireContext(), fitnessOptions)

    /*
     * Handles the callback from the OAuth sign in flow, executing the function
     * after sign-in is complete.
     */
    override fun onActivityResult(
            requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        when (resultCode) {
            RESULT_OK -> {
                readDailySteps()
            }
            else -> {
                // Handle error.
            }
        }
    }

    /*
     * Reads the current daily step total.
     */
    private fun readDailySteps() {
        Fitness.getHistoryClient(requireContext(), getGoogleAccount())
            .readDailyTotal(DataType.TYPE_STEP_COUNT_DELTA)
            .addOnSuccessListener { dataSet ->
                val total = when {
                    dataSet.isEmpty -> 0
                    else -> dataSet.dataPoints.first()
                            .getValue(Field.FIELD_STEPS).asInt()
                }

                Log.i(TAG, "Total steps: $total")
            }
            .addOnFailureListener { e ->
                Log.w(TAG, "There was a problem getting the step count.", e)
            }
    }

    companion object {
        const val SIGN_IN_REQUEST_CODE = 1001
    }
}

Java

public class FitFragment extends Fragment {
    private final FitnessOptions fitnessOptions = FitnessOptions.builder()
            .addDataType(DataType.TYPE_STEP_COUNT_CUMULATIVE)
            .addDataType(DataType.TYPE_STEP_COUNT_DELTA)
            .build();

    @Override
    public void onViewCreated(
            @NotNull View view, @Nullable Bundle savedInstanceState) {
        fitSignIn();
    }

    /*
     * Checks whether the user is signed in. If so, executes the specified
     * function. If the user is not signed in, initiates the sign-in flow,
     * specifying the function to execute after the user signs in.
     */
    private void fitSignIn() {
        if (oAuthPermissionsApproved()) {
            readDailySteps();
        } else {
            GoogleSignIn.requestPermissions(this, SIGN_IN_REQUEST_CODE,
                    getGoogleAccount(), fitnessOptions);
        }
    }

    private boolean oAuthPermissionsApproved() {
        return GoogleSignIn.hasPermissions(getGoogleAccount(), fitnessOptions);
    }

    /*
     * Gets a Google account for use in creating the fitness client. This is
     * achieved by either using the last signed-in account, or if necessary,
     * prompting the user to sign in. It's better to use the
     * getAccountForExtension() method instead of the getLastSignedInAccount()
     * method because the latter can return null if there has been no sign in
     * before.
     */
    private GoogleSignInAccount getGoogleAccount() {
        return GoogleSignIn.getAccountForExtension(
                requireContext(), fitnessOptions);
    }

    /*
     * Handles the callback from the OAuth sign in flow, executing the function
     * after sign-in is complete.
     */
    @Override
    public void onActivityResult(
            int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (resultCode == RESULT_OK) {
            readDailySteps();
        } else {
            // Handle error.
        }
    }

    /*
     * Reads the current daily step total.
     */
    private void readDailySteps() {
        AtomicInteger total = new AtomicInteger();
        Fitness.getHistoryClient(requireContext(), getGoogleAccount())
                .readDailyTotal(DataType.TYPE_STEP_COUNT_DELTA)
                .addOnSuccessListener(dataSet -> {
                    if (!dataSet.isEmpty())
                        total.set(Integer.parseInt(dataSet.getDataPoints()
                                .get(0).getValue(FIELD_STEPS).toString()));
                        Log.i(TAG, "Total steps: $total");
                })
                .addOnFailureListener(e -> {
                    Log.w(TAG, "There was a problem getting the step count.", e);
                });
    }

    private static final int SIGN_IN_REQUEST_CODE = 1001;
}

API kullanılabilirliğini kontrol edin

Uygulamanızda Google Play hizmetlerine bağlı bir özelliği etkinleştirmeden önce API'nin cihazda kullanılabilir olup olmadığını kontrol edin. Bunun için, checkApiAvailability() numaralı telefonu arayın.

Not: Bu kontrol yalnızca uygulamanızdaki bir özelliği devre dışı bırakmanız gerektiğinde gereklidir bir API kullanılamaz. API yöntemlerini Bu kontrolün uygulanmasının nedeni, API'nin kullanılabilir değil.

Aşağıdaki kod snippet'i, çok yönlü konum sağlayıcıdır.

Kotlin

fun getLastLocationIfApiAvailable(context: Context?): Task<Location>? {
    val client = getFusedLocationProviderClient(context)
    return GoogleApiAvailability.getInstance()
        .checkApiAvailability(client)
        .onSuccessTask { _ -> client.lastLocation }
        .addOnFailureListener { _ -> Log.d(TAG, "Location unavailable.")}
}

Java

public Task<Location> getLastLocationIfApiAvailable(Context context) {
    FusedLocationProviderClient client =
            getFusedLocationProviderClient(context);
    return GoogleApiAvailability.getInstance()
            .checkApiAvailability(client)
            .onSuccessTask(unused -> client.getLastLocation())
            .addOnFailureListener(e -> Log.d(TAG, "Location unavailable."));
}