Mengakses 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 mengerjakan data mereka layanan IT perusahaan mereka. Untuk mengakses layanan ini, aplikasi harus menerapkan salah satu OAuth 2.0 alur klien untuk mendapatkan izin dari pengguna dan memperoleh token akses, yang memberikan akses ke API.

Anda dapat menggunakan library Login dengan Google, yang menerapkan alur OAuth 2.0 untuk untuk mendapatkan token akses bagi pengguna yang telah masuk.

Sebelum memulai

Anda harus menyelesaikan integrasi Login dengan Google dasar.

1. Memeriksa cakupan yang telah diberikan

Sebelum Anda melakukan panggilan ke Google API, periksa cakupan mana yang sudah diberikan ke aplikasi Anda, menggunakan properti grantedScopes dari GIDGoogleUser:

Swift

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 ruang lingkup tambahan untuk mendukung interaksi.

2. Meminta cakupan tambahan

Jika Anda perlu meminta cakupan tambahan, panggil addScopes:presentingViewController:completion atau addScopes:presentingWindow:completion untuk meminta pengguna mengizinkan aplikasi Anda akses tambahan.

Misalnya, untuk meminta akses hanya baca ke file Drive pengguna:

Swift

let additionalScopes = ["https://www.googleapis.com/auth/drive.readonly"]
guard let currentUser = GIDSignIn.sharedInstance.currentUser else {
    return ;  /* Not signed in. */
}

currentUser.addScopes(additionalScopes, presenting: self) { signInResult, error in
    guard error == nil else { return }
    guard let signInResult = signInResult else { return }

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

Objective-C

NSArray *additionalScopes = @[ @"https://www.googleapis.com/auth/drive.readonly" ];
GIDGoogleUser *currentUser = GIDSignIn.sharedInstance.currentUser;

[currentUser addScopes:additionalScopes
           presentingViewController:self
                         completion:^(GIDSignInResult * _Nullable signInResult,
                                      NSError * _Nullable error) {
    if (error) { return; }
    if (signInResult == nil) { return; }

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

3. Melakukan panggilan API dengan token baru

Untuk memastikan bahwa panggilan Google API Anda selalu memiliki token akses yang belum habis masa berlakunya dilampirkan, gabungkan panggilan dalam blok refreshTokensIfNeededWithCompletion::

Swift

currentUser.refreshTokensIfNeeded { user, error in
    guard error == nil else { return }
    guard let user = user else { return }

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

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

Objective-C

[currentUser refreshTokensIfNeededWithCompletion:^(
                              GIDGoogleUser * _Nullable user,
                              NSError * _Nullable error) {
    if (error) { return; }
    if (user == nil) { return; }

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

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

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