iOS uygulamasında Google API'lerine erişme

Drive, Gmail ve diğer birçok Google hizmeti, kullanıcıların bu hizmetlerdeki verileriyle çalışmasına yardımcı olan uygulamalar oluşturmak için kullanabileceğiniz herkese açık API'ler sağlar. Uygulamaların bu hizmetlere erişebilmesi için OAuth 2.0 istemci akışlarından birini uygulayarak kullanıcılardan izin alması ve API'lere erişim izni veren erişim jetonları edinmesi gerekir.

Oturum açmış kullanıcının erişim jetonlarını almak için Google ile Oturum Açma kitaplığını kullanabilirsiniz. Bu kitaplık, OAuth 2.0 akışını sizin için uygular.

Başlamadan önce

Temel Google ile Oturum Açma entegrasyonunu tamamlamanız gerekir.

1. Hangi kapsamların verildiğini kontrol etme

Bir Google API'sine çağrı yapmadan önce, grantedScopes özelliğini kullanarak uygulamanıza hangi kapsamların verildiğini kontrol edin: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
}

Belirli bir kapsamın kullanıcı tarafından verilip verilmediğine bağlı olarak, belirli bir etkileşimi desteklemek için ek kapsam isteğinde bulunmanız gerekebilir.

2. Ek kapsam isteğinde bulunma

Ek kapsam istemeniz gerekiyorsa kullanıcıdan uygulamanıza ek erişim izni vermesini istemek için addScopes:presentingViewController:completion veya addScopes:presentingWindow:completion işlevini çağırın.

Örneğin, bir kullanıcının Drive dosyalarına salt okuma erişimi istemek için:

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. Yeni jetonlarla API çağrısı yapma

Google API çağrılarınızın her zaman süresi dolmamış erişim jetonları içerdiğinden emin olmak için çağrıları bir refreshTokensIfNeededWithCompletion: bloğuna sarın:

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];
}];

Erişim jetonunu bir REST veya gRPC isteğinin üstbilgisine (Authorization: Bearer ACCESS_TOKEN) ekleyerek ya da Google API'leri İstemci Kitaplığı ile fetcher yetkilendiricisini kullanarak API'yi çağırmak için kullanın.