iOS uygulamasında Google API'lerine erişme

Drive ve Gmail gibi bazı Google hizmetleri, 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 sağlayan erişim jetonları edinmesi gerekir.

Oturum açmış kullanıcı için erişim jetonları almak üzere OAuth 2.0 akışını sizin için uygulayan Google ile Oturum Açma kitaplığını kullanabilirsiniz.

Ön koşullar

iOS uygulamanızın Google API'lerini çağırabilmesi için aşağıdaki kurulum adımlarını tamamlayın:

1. Projeniz için API'leri etkinleştirme

Google API'lerini çağıran tüm uygulamaların bu API'leri Google Cloud Console'da etkinleştirmesi gerekir.

Projeniz için bir API'yi etkinleştirmek üzere:

  1. Google Cloud Console'da API Kitaplığı'nı açın.
  2. İstenirse bir proje seçin veya yeni bir proje oluşturun.
  3. Etkinleştirmek istediğiniz API'yi seçip Etkinleştir'i tıklayın.

2. Yetkilendirme kimlik bilgileri oluşturma

Google API'lerine erişmek için OAuth 2.0 kullanan tüm iOS uygulamalarının, uygulamayı Google yetkilendirme sunucusuna tanımlayan yetkilendirme kimlik bilgilerine sahip olması gerekir. Aşağıdaki adımlarda, projeniz için kimlik bilgilerinin nasıl oluşturulacağı açıklanmaktadır:

  1. Google Cloud Console'da Kimlik bilgileri sayfasına gidin.
  2. İstemci oluştur'u (veya Kimlik bilgileri oluştur > OAuth istemci kimliği'ni) tıklayın.
  3. iOS uygulama türünü seçin.
  4. OAuth istemcisi için bir ad girin. Bu ad, projenizin Kimlik Bilgileri sayfasında istemciyi tanımlar.
  5. Uygulamanızın paket kimliğini girin. Paket kimliği, uygulamanızın Info.plist dosyasındaki CFBundleIdentifier anahtarının değeridir. Değer genellikle Xcode proje düzenleyicisinin Genel bölmesinde veya İmzalama ve Özellikler bölmesinde ya da Apple App Store Connect'teki Uygulama Bilgileri sayfasında gösterilir. Uygulama Kontrolü'nü kullanıyorsanız değiştirilemeyeceği için doğru paket kimliğini kullandığınızdan emin olun.
  6. (İsteğe bağlı) Uygulama, Apple Uygulama Mağazası'nda yayınlanıyorsa uygulamanızın Uygulama Mağazası kimliğini girin. Mağaza kimliği, her Apple uygulama mağazası URL'sinde bulunan sayısal bir dizedir.
  7. (İsteğe bağlı) Ekip kimliğinizi girin. Apple Geliştirici Hesabı belgelerindeki Ekip kimliğinizi bulma bölümüne bakın. İstemciniz için Uygulama Kontrolü'nü etkinleştirirseniz Ekip Kimliği gerekir.
  8. (İsteğe bağlı) iOS uygulamanız için Uygulama Kontrolü'nü etkinleştirin. Uygulama Kontrolü'nü etkinleştirdiğinizde OAuth istemcinizden gelen OAuth 2.0 isteklerinin orijinal olduğunu ve uygulamanızdan geldiğini doğrulamak için Apple'ın App Attest hizmeti kullanılır. Bu sayede, uygulama kimliğine bürünme riski azaltılır.
  9. Oluştur'u tıklayın.

İstemci kimliğiniz oluşturulur ve Google Cloud Console'da gösterilir. Yetkilendirme yönlendirmelerini işlemek için uygulamanızın Info.plist dosyasına ters istemci kimliği URL şemasını (ör. com.googleusercontent.apps.1234567890-abcdef) ekleyin.

3. Temel Google ile Oturum Açma entegrasyonunu tamamlama

Artımlı kapsamları istemeden ve Google API'lerini çağırmadan önce temel Google ile Oturum Açma entegrasyonunu tamamlayın.

1. Hangi kapsamların verildiğini kontrol etme

Bir Google API'sini çağırmadan önce, GIDGoogleUser öğesinin grantedScopes özelliğini kullanarak uygulamanıza hangi kapsamların verildiğini kontrol edin:

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 bir kapsam isteğinde bulunmanız gerekebilir.

2. Ek kapsamlar isteme

Ek kapsamlar 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ı eklenmiş olarak gönderilmesini sağlamak için çağrıları bir refreshTokensIfNeededWithCompletion: bloğuna sarmalayı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 başlığına ekleyerek (Authorization: Bearer ACCESS_TOKEN) ya da Google API'leri İstemci Kitaplığı ile getirici yetkilendiriciyi kullanarak API'yi çağırmak için erişim jetonunu kullanın.