Uzyskiwanie dostępu do interfejsów API Google z backendu aplikacji

Jeśli chcesz, aby Twoje serwery mogły wykonywać wywołania interfejsu API Google w imieniu użytkowników lub gdy są offline.

Zanim zaczniesz

Musisz przejść podstawową integrację logowania przez Google.

Włącz dostęp do interfejsu API po stronie serwera dla swojej aplikacji

Na stronie Dostęp do interfejsów API Google w aplikacji na iOS aplikacja uwierzytelnia użytkownika tylko po stronie klienta. W takim przypadku aplikacja może uzyskać dostęp do interfejsów API Google tylko wtedy, gdy użytkownik aktywnie korzysta z aplikacji.

Dzięki procedurze opisanej na tej stronie serwery mogą wykonywać wywołania interfejsu Google API w imieniu użytkowników, gdy są oni offline. Aplikacja do obsługi zdjęć może na przykład ulepszyć zdjęcie znajdujące się w albumie użytkownika w Zdjęciach Google, przetwarzając je na serwerze backendu i przesyłając wynik do innego albumu. Do tego celu serwer wymaga tokena dostępu i tokena odświeżania.

Aby uzyskać token dostępu i token odświeżania dla swojego serwera, możesz poprosić o jednorazowy kod autoryzacji, który Twój serwer wymienia na te 2 tokeny. Po zalogowaniu się zobaczysz jednorazowy kod jako właściwość serverAuthCode obiektu GIDSignInResult.

  1. Uzyskaj identyfikator klienta serwera (jeśli jeszcze go nie masz), umieść go w pliku Info.plist aplikacji poniżej identyfikatora klienta OAuth.

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

  2. W wywołaniu zwrotnym logowania pobierz jednorazowy kod autoryzacji:

    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. W bezpieczny sposób przekaż ciąg serverAuthCode na swój serwer za pomocą metody HTTPS POST.

  4. Na serwerze backendu aplikacji wymieniaj kod autoryzacji na dostęp i tokeny odświeżania. Za pomocą tokena dostępu możesz wywoływać interfejsy API Google w imieniu użytkownika i opcjonalnie przechowywać token odświeżania, aby uzyskać nowy token dostępu po jego wygaśnięciu.

    Na przykład:

    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']