دسترسی به Google API از پشتیبان برنامه خود

اگر می‌خواهید سرورهای شما بتوانند از طرف کاربران یا در حالت آفلاین بودن آنها، فراخوانی‌های Google API را انجام دهند، این روش را دنبال کنید.

قبل از اینکه شروع کنی

شما باید یکپارچه‌سازی اولیه ورود به سیستم با گوگل را تکمیل کنید.

دسترسی API سمت سرور را برای برنامه خود فعال کنید

در صفحه Access Google APIs in an iOS app ، برنامه شما فقط کاربر را در سمت کلاینت احراز هویت می‌کند؛ در این صورت، برنامه شما فقط زمانی می‌تواند به Google APIs دسترسی داشته باشد که کاربر به طور فعال از برنامه شما استفاده کند.

با روشی که در این صفحه شرح داده شده است، سرورهای شما می‌توانند از طرف کاربران در حالت آفلاین، فراخوانی‌های Google API را انجام دهند. به عنوان مثال، یک برنامه عکس می‌تواند با پردازش عکس در آلبوم Google Photos کاربر در یک سرور backend و آپلود نتیجه به آلبوم دیگر، آن را بهبود بخشد. برای انجام این کار، سرور شما به یک توکن دسترسی و یک توکن refresh نیاز دارد.

برای دریافت توکن دسترسی و توکن به‌روزرسانی برای سرور خود، می‌توانید یک کد مجوز یکبار مصرف درخواست کنید که سرور شما آن را با این دو توکن مبادله می‌کند. پس از ورود موفقیت‌آمیز، کد یکبار مصرف را به عنوان ویژگی serverAuthCode از GIDSignInResult خواهید یافت.

  1. اگر هنوز این کار را نکرده‌اید، یک شناسه کلاینت سرور دریافت کنید و آن را در فایل Info.plist برنامه خود، زیر شناسه کلاینت OAuth خود، مشخص کنید.

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

  2. در فراخوانی ورود به سیستم، کد مجوز یکبار مصرف را بازیابی کنید:

    سویفت

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

    هدف-سی

    [GIDSignIn.sharedInstance
              signInWithPresentingViewController:self
                                      completion:^(GIDSignInResult * _Nullable signInResult,
                                                   NSError * _Nullable error) {
          if (error) { return; }
          if (signInResult == nil) { return; }
    
          NSString *authCode = signInResult.serverAuthCode;
    }];
    
  3. رشته serverAuthCode را با استفاده از HTTPS POST به طور ایمن به سرور خود منتقل کنید.

  4. در سرور بک‌اند برنامه خود، کد احراز هویت را با توکن‌های دسترسی و به‌روزرسانی مبادله کنید. از توکن دسترسی برای فراخوانی APIهای گوگل از طرف کاربر استفاده کنید و به صورت اختیاری، توکن به‌روزرسانی را برای دریافت یک توکن دسترسی جدید پس از انقضای توکن دسترسی ذخیره کنید.

    برای مثال:

    جاوا
    // (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");
    پایتون
    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']