Accéder aux API Google à partir du backend de votre application

Suivez cette procédure si vous souhaitez que vos serveurs puissent effectuer des appels d'API Google au nom des utilisateurs ou lorsqu'ils sont hors connexion.

Avant de commencer

Vous devez effectuer l'intégration Google Sign-In de base.

Activer l'accès API côté serveur pour votre application

Sur la page Accéder aux API Google dans une application iOS, votre application n'authentifie l'utilisateur que côté client. Dans ce cas, votre application ne peut accéder aux API Google que lorsque l'utilisateur l'utilise activement .

Grâce à la procédure décrite sur cette page, vos serveurs peuvent effectuer des appels d'API Google au nom des utilisateurs lorsqu'ils sont hors connexion. Par exemple, une application photo peut améliorer une photo dans l'album Google Photos d'un utilisateur en la traitant sur un serveur backend et en important le résultat dans un autre album. Pour ce faire, votre serveur a besoin d'un jeton d'accès et d'un jeton d'actualisation.

Pour obtenir un jeton d'accès et un jeton d'actualisation pour votre serveur, vous pouvez demander un code d'autorisation unique que votre serveur échange contre ces deux jetons. Une fois la connexion établie, vous trouverez le code unique en tant que la serverAuthCode propriété de GIDSignInResult.

  1. Si ce n'est pas déjà fait, obtenez un ID client serveur et spécifiez-le dans le fichier Info.plist de votre application, sous votre ID client OAuth.

    <key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>

  2. Dans votre rappel de connexion, récupérez le code d'autorisation unique :

    Swift

    GIDSignIn.sharedInstance.signIn(withPresenting: self) { signInResult, error in
    guard error == nil else { return }
    guard let signInResult = signInResult else { return }

    let authCode = signInResult.serverAuthCode
}

    Objective-C

    [GIDSignIn.sharedInstance
          signInWithPresentingViewController:self
                                  completion:^(GIDSignInResult * _Nullable signInResult,
                                               NSError * _Nullable error) {
      if (error) { return; }
      if (signInResult == nil) { return; }

      NSString *authCode = signInResult.serverAuthCode;
}];

  3. Transmettez de manière sécurisée la chaîne serverAuthCode à votre serveur à l'aide de la méthode HTTPS POST.

  4. Sur le serveur backend de votre application, échangez le code d'autorisation contre des jetons d'accès et d'actualisation. Utilisez le jeton d'accès pour appeler les Google APIs au nom de l'utilisateur et, éventuellement, stockez le jeton d'actualisation pour acquérir un nouveau jeton d'accès lorsque le jeton d'accès expirera.

    Exemple :

    Java
    // (Receive authCode via HTTPS POST)


if (request.getHeader("X-Requested-With") == null) {
  // Without the `X-Requested-With` header, this request could be forged. Aborts.
}

// Set path to the Web application client_secret_*.json file you downloaded from the
// Google API Console: https://console.cloud.google.com/apis/credentials
// You can also find your Web application client ID and client secret from the
// console and specify them directly when you create the GoogleAuthorizationCodeTokenRequest
// object.
String CLIENT_SECRET_FILE = "/path/to/client_secret.json";

// Exchange auth code for access token
GoogleClientSecrets clientSecrets =
    GoogleClientSecrets.load(
        JacksonFactory.getDefaultInstance(), new FileReader(CLIENT_SECRET_FILE));
GoogleTokenResponse tokenResponse =
          new GoogleAuthorizationCodeTokenRequest(
              new NetHttpTransport(),
              JacksonFactory.getDefaultInstance(),
              "https://oauth2.googleapis.com/token",
              clientSecrets.getDetails().getClientId(),
              clientSecrets.getDetails().getClientSecret(),
              authCode,
              REDIRECT_URI)  // Specify the same redirect URI that you use with your web
                             // app. If you don't have a web version of your app, you can
                             // specify an empty string.
              .execute();

String accessToken = tokenResponse.getAccessToken();

// Use access token to call API
GoogleCredential credential = new GoogleCredential().setAccessToken(accessToken);
Drive drive =
    new Drive.Builder(new NetHttpTransport(), JacksonFactory.getDefaultInstance(), credential)
        .setApplicationName("Auth Code Exchange Demo")
        .build();
File file = drive.files().get("appfolder").execute();

// Get profile info from ID token
GoogleIdToken idToken = tokenResponse.parseIdToken();
GoogleIdToken.Payload payload = idToken.getPayload();
String userId = payload.getSubject();  // Use this value as a key to identify a user.
String email = payload.getEmail();
boolean emailVerified = Boolean.valueOf(payload.getEmailVerified());
String name = (String) payload.get("name");
String pictureUrl = (String) payload.get("picture");
String locale = (String) payload.get("locale");
String familyName = (String) payload.get("family_name");
String givenName = (String) payload.get("given_name");
    Python
    from apiclient import discovery
import httplib2
from oauth2client import client

# (Receive auth_code by HTTPS POST)


# If this request does not have `X-Requested-With` header, this could be a CSRF
if not request.headers.get('X-Requested-With'):
    abort(403)

# Set path to the Web application client_secret_*.json file you downloaded from the
# Google API Console: https://console.cloud.google.com/apis/credentials
CLIENT_SECRET_FILE = '/path/to/client_secret.json'

# Exchange auth code for access token, refresh token, and ID token
credentials = client.credentials_from_clientsecrets_and_code(
    CLIENT_SECRET_FILE,
    ['https://www.googleapis.com/auth/drive.appdata', 'profile', 'email'],
    auth_code)

# Call Google API
http_auth = credentials.authorize(httplib2.Http())
drive_service = discovery.build('drive', 'v3', http=http_auth)
appfolder = drive_service.files().get(fileId='appfolder').execute()

# Get profile info from ID token
userid = credentials.id_token['sub']
email = credentials.id_token['email']