این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

قبل از شروع

باید ادغام اولیه ورود به سیستم Google را تکمیل کنید.

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

در دسترسی به APIهای Google در صفحه برنامه iOS ، برنامه شما فقط در سمت سرویس گیرنده کاربر را احراز هویت می کند. در این صورت، برنامه شما تنها زمانی می‌تواند به Google API دسترسی داشته باشد که کاربر فعالانه از برنامه شما استفاده می‌کند.

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

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

اگر قبلاً این کار را نکرده‌اید، یک شناسه سرویس گیرنده سرور دریافت کنید و آن را در فایل Info.plist برنامه خود در زیر شناسه مشتری OAuth خود مشخص کنید.
```
<key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>
```

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

سویفت

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

    let authCode = signInResult.serverAuthCode
}

هدف-C

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

      NSString *authCode = signInResult.serverAuthCode;
}];

با استفاده از HTTPS POST، رشته serverAuthCode ایمن به سرور خود منتقل کنید.

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

به عنوان مثال:

جاوا

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