سيتم إيقاف "مكتبة منصّة JavaScript لتسجيل الدخول إلى Google" على الويب. لن تكون المكتبة متاحة للتنزيل بعد 31 آذار (مارس) 2023. وبدلاً من ذلك، استخدم خدمات Google Identity الجديدة على الويب.
حسب الإعدادات التلقائية، يتم الآن حظر استخدام معرّفات Client ID الجديدة في مكتبة النظام الأساسي، ولن تتأثر معرّفات Client ID الحالية. يمكن لمعرّفات العملاء الجديدة التي تم إنشاؤها قبل 29 تموز (يوليو) 2022 ضبط `plugin_name` لتفعيل استخدام "منصة Google" الأساسية.

تمكين الوصول من جانب الخادم

من خلال إجراء إضافة تسجيل الدخول السابق ، يقوم التطبيق الخاص بك بمصادقة المستخدم من جانب العميل فقط ؛ في هذه الحالة ، لا يمكنك الوصول إلى Google APIs إلا أثناء استخدام المستخدم لتطبيقك بشكل نشط. إذا كنت تريد أن تكون خوادمك قادرة على إجراء مكالمات Google API نيابة عن المستخدمين - ربما أثناء عدم اتصالهم بالإنترنت - يتطلب خادمك رمز دخول مميز.

قبل ان تبدأ

قم بتمكين الوصول إلى واجهة برمجة التطبيقات من جانب الخادم لتطبيقك

  1. عند تكوين جوجل الدخول في ، بناء GoogleSignInOptions الاعتراض مع requestServerAuthCode الطريقة وتحديد نطاقات التي يحتاجها الخلفية التطبيق الخاص بك للوصول مع requestScopes الأسلوب.

    قم بتمرير معرف عميل الخادم الخاص بك إلى طريقة requestServerAuthCode .

    // Configure sign-in to request offline access to the user's ID, basic
    // profile, and Google Drive. The first time you request a code you will
    // be able to exchange it for an access token and refresh token, which
    // you should store. In subsequent calls, the code will only result in
    // an access token. By asking for profile access (through
    // DEFAULT_SIGN_IN) you will also get an ID Token as a result of the
    // code exchange.
    String serverClientId = getString(R.string.server_client_id);
    GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
            .requestScopes(new Scope(Scopes.DRIVE_APPFOLDER))
            .requestServerAuthCode(serverClientId)
            .requestEmail()
            .build();
  2. بعد نجاح المستخدم في تسجيل الدخول ، احصل على رمز مصادقة للمستخدم باستخدام getServerAuthCode :

    Task<GoogleSignInAccount> task = GoogleSignIn.getSignedInAccountFromIntent(data);
    try {
        GoogleSignInAccount account = task.getResult(ApiException.class);
        String authCode = account.getServerAuthCode();
    
        // Show signed-un UI
        updateUI(account);
    
        // TODO(developer): send code to server and exchange for access/refresh/ID tokens
    } catch (ApiException e) {
        Log.w(TAG, "Sign-in failed", e);
        updateUI(null);
    }
  3. أرسل رمز المصادقة إلى الواجهة الخلفية لتطبيقك باستخدام HTTPS POST:

    HttpPost httpPost = new HttpPost("https://yourbackend.example.com/authcode");
    
    try {
        List<NameValuePair> nameValuePairs = new ArrayList<NameValuePair>(1);
        nameValuePairs.add(new BasicNameValuePair("authCode", authCode));
        httpPost.setEntity(new UrlEncodedFormEntity(nameValuePairs));
    
        HttpResponse response = httpClient.execute(httpPost);
        int statusCode = response.getStatusLine().getStatusCode();
        final String responseBody = EntityUtils.toString(response.getEntity());
    } catch (ClientProtocolException e) {
        Log.e(TAG, "Error sending auth code to backend.", e);
    } catch (IOException e) {
        Log.e(TAG, "Error sending auth code to backend.", e);
    }
    
  4. على خادم الواجهة الخلفية لتطبيقك ، قم بتبادل رمز المصادقة للوصول وتحديث الرموز المميزة. استخدم رمز الوصول للاتصال بواجهات Google APIs نيابة عن المستخدم ، واختياريًا ، قم بتخزين رمز التحديث للحصول على رمز وصول جديد عند انتهاء صلاحية رمز الوصول.

    إذا طلبت الوصول إلى ملف التعريف ، فستحصل أيضًا على رمز مميز للمعرف يحتوي على معلومات الملف الشخصي الأساسية للمستخدم.

    على سبيل المثال:

    جافا
    // (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.developers.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.developers.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']