Akses Google API di aplikasi iOS

Beberapa layanan Google, seperti Drive, Gmail, dan banyak lainnya, menyediakan API publik yang dapat Anda gunakan untuk membuat aplikasi yang membantu pengguna bekerja dengan data mereka di layanan ini. Untuk mengakses layanan ini, aplikasi harus menerapkan salah satu alur klien OAuth 2.0 untuk mendapatkan persetujuan dari pengguna dan mendapatkan token akses , yang memberikan akses ke API.

Anda dapat menggunakan pustaka Google Sign-In, yang mengimplementasikan alur OAuth 2.0 untuk Anda, guna mendapatkan token akses bagi pengguna yang masuk.

Sebelum kamu memulai

Anda harus menyelesaikan integrasi Google Sign-In dasar .

1. Periksa cakupan mana yang telah diberikan

Sebelum Anda membuat panggilan ke API Google, memeriksa lingkup telah diberikan kepada aplikasi Anda, menggunakan grantedScopes milik GIDGoogleUser :

Cepat

let driveScope = "https://www.googleapis.com/auth/drive.readonly"
let grantedScopes = user.grantedScopes
if grantedScopes == nil || !grantedScopes!.contains(driveScope) {
  // Request additional Drive scope.
}

Objective-C

NSString *driveScope = @"https://www.googleapis.com/auth/drive.readonly";

// Check if the user has granted the Drive scope
if (![user.grantedScopes containsObject:driveScope]) {
  // request additional drive scope
}

Berdasarkan apakah cakupan tertentu telah diberikan oleh pengguna atau tidak, Anda mungkin perlu membuat permintaan untuk cakupan tambahan guna mendukung interaksi tertentu.

2. Minta cakupan tambahan

Jika Anda perlu meminta cakupan tambahan, panggil addScopes:presentingViewController:callback; untuk meminta pengguna memberikan akses tambahan kepada aplikasi Anda.

Misalnya, untuk meminta akses hanya baca ke Drive pengguna:

Cepat

let additionalScopes = ["https://www.googleapis.com/auth/drive.readonly"]
GIDSignIn.sharedInstance.addScopes(additionalScopes, presenting: self) { user, error in
    guard error == nil else { return }
    guard let user = user else { return }

    // Check if the user granted access to the scopes you requested.
}

Objective-C

NSArray *additionalScopes = @[ @"https://www.googleapis.com/auth/drive.readonly" ];
[GIDSignIn.sharedInstance addScopes:additionalScopes
           presentingViewController:self
                           callback:^(GIDGoogleUser * _Nullable user,
                                      NSError * _Nullable error) {
    if (error) { return; }
    if (user == nil) { return; }

    // Check if the user granted access to the scopes you requested.
}];

3. Lakukan panggilan API dengan token baru

Untuk memastikan bahwa panggilan Google API Anda selalu memiliki token akses yang belum doWithFreshTokens: , bungkus panggilan dalam blok doWithFreshTokens: ::

Cepat

user.authentication.do { authentication, error in
    guard error == nil else { return }
    guard let authentication = authentication else { return }

    // Get the access token to attach it to a REST or gRPC request.
    let accessToken = authentication.accessToken

    // Or, get an object that conforms to GTMFetcherAuthorizationProtocol for
    // use with GTMAppAuth and the Google APIs client library.
    let authorizer = authentication.fetcherAuthorizer()
}

Objective-C

[user.authentication doWithFreshTokens:^(GIDAuthentication * _Nullable authentication,
                                         NSError * _Nullable error) {
    if (error) { return; }
    if (authentication == nil) { return; }

    // Get the access token to attach it to a REST or gRPC request.
    NSString *accessToken = authentication.accessToken;

    // Or, get an object that conforms to GTMFetcherAuthorizationProtocol for
    // use with GTMAppAuth and the Google APIs client library.
    id<GTMFetcherAuthorizationProtocol> authorizer = [authentication fetcherAuthorizer];
}];

Gunakan token akses untuk memanggil API, dengan menyertakan token akses di header permintaan REST atau gRPC ( Authorization: Bearer ACCESS_TOKEN ), atau dengan menggunakan fetcher authorizer dengan Pustaka Klien Google API .