Alcuni servizi Google, come Drive, Gmail e molti altri, forniscono API pubbliche che puoi utilizzare per creare app che aiutino gli utenti a utilizzare i propri dati in queste i servizi di machine learning. Per accedere a questi servizi, le app devono implementare un protocollo OAuth 2.0 per ottenere il consenso degli utenti e ottenere i token di accesso, che concedono l'accesso alle API.
Puoi utilizzare la libreria Accedi con Google, che implementa il flusso OAuth 2.0 per per ottenere i token di accesso per l'utente che ha eseguito l'accesso.
Prima di iniziare
Devi completare l'integrazione di base di Accedi con Google.
1. Controlla quali ambiti sono stati concessi
Prima di effettuare una chiamata a un'API di Google, verifica quali ambiti sono già stati
concesso alla tua app utilizzando la proprietà grantedScopes
di 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
}
A seconda che l'utente abbia concesso o meno un determinato ambito, puoi richiedere un ambito aggiuntivo per poter supportare un particolare un'interazione.
2. Richiedi ambiti aggiuntivi
Se hai bisogno di richiedere ambiti aggiuntivi, chiama
addScopes:presentingViewController:completion
o
addScopes:presentingWindow:completion
per chiedere all'utente di concedere la tua app
accesso aggiuntivo.
Ad esempio, per richiedere l'accesso di sola lettura ai file di Drive di un utente:
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. Effettuare una chiamata API con token aggiornati
Assicurati che le chiamate API di Google abbiano sempre token di accesso non scaduti
allegato, aggrega le chiamate in un blocco 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];
}];
Utilizza il token di accesso per chiamare l'API includendo il token di accesso nel
l'intestazione di una richiesta REST o gRPC (Authorization: Bearer ACCESS_TOKEN
),
o utilizzando l'autorizzazione fetcher con
Libreria client delle API di Google.