iOS ऐप्लिकेशन में Google API ऐक्सेस करना

Google की कुछ सेवाएं, जैसे कि Drive, Gmail वगैरह, सार्वजनिक एपीआई उपलब्ध कराती हैं. इनका इस्तेमाल करके, ऐसे ऐप्लिकेशन बनाए जा सकते हैं जो उपयोगकर्ताओं को इन सेवाओं में मौजूद अपने डेटा के साथ काम करने में मदद करते हैं. इन सेवाओं को ऐक्सेस करने के लिए, ऐप्लिकेशन को OAuth 2.0 क्लाइंट फ़्लो में से किसी एक को लागू करना होगा. इससे उपयोगकर्ताओं की सहमति ली जा सकेगी और ऐक्सेस टोकन हासिल किए जा सकेंगे. इन टोकन की मदद से, एपीआई को ऐक्सेस किया जा सकता है.

साइन इन किए हुए उपयोगकर्ता के लिए ऐक्सेस टोकन पाने के लिए, Google साइन-इन लाइब्रेरी का इस्तेमाल किया जा सकता है. यह लाइब्रेरी, आपके लिए OAuth 2.0 फ़्लो को लागू करती है.

ज़रूरी शर्तें

आपका iOS ऐप्लिकेशन, Google API को कॉल कर सके, इसके लिए सेटअप करने का यह तरीका अपनाएं:

1. अपने प्रोजेक्ट के लिए एपीआई चालू करना

Google API को कॉल करने वाले किसी भी ऐप्लिकेशन को Google Cloud Console में उन एपीआई को चालू करना होगा.

अपने प्रोजेक्ट के लिए कोई एपीआई चालू करने के लिए:

1. Google Cloud Console में एपीआई लाइब्रेरी खोलें.
2. अगर कहा जाए, तो कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं.
3. आपको जो एपीआई चालू करना है उसे चुनें. इसके बाद, चालू करें पर क्लिक करें.

2. अनुमति देने के लिए क्रेडेंशियल बनाना

Google API को ऐक्सेस करने के लिए, OAuth 2.0 का इस्तेमाल करने वाले किसी भी iOS ऐप्लिकेशन के पास अनुमति देने वाले क्रेडेंशियल होने चाहिए. इनसे Google के अनुमति देने वाले सर्वर को ऐप्लिकेशन की पहचान करने में मदद मिलती है. अपने प्रोजेक्ट के लिए क्रेडेंशियल बनाने का तरीका यहां बताया गया है:

1. Google Cloud Console में क्रेडेंशियल पेज पर जाएं.
2. क्लाइंट बनाएं (या क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी) पर क्लिक करें.
3. iOS ऐप्लिकेशन टाइप चुनें.
4. OAuth क्लाइंट के लिए कोई नाम डालें. इस नाम से, आपके प्रोजेक्ट के क्रेडेंशियल पेज पर क्लाइंट की पहचान की जाती है.
5. अपने ऐप्लिकेशन के लिए बंडल आईडी डालें. बंडल आईडी, आपके ऐप्लिकेशन के Info.plist में मौजूद CFBundleIdentifier कुंजी की वैल्यू होती है. आम तौर पर, यह वैल्यू Xcode प्रोजेक्ट एडिटर के General पैनल या Signing & Capabilities पैनल में दिखती है. इसके अलावा, यह Apple App Store Connect में ऐप्लिकेशन की जानकारी वाले पेज पर भी दिखती है. पुष्टि करें कि आपने सही बंडल आईडी का इस्तेमाल किया है. ऐसा इसलिए, क्योंकि App Check का इस्तेमाल करने पर इसे बदला नहीं जा सकता.
6. (ज़रूरी नहीं) अगर ऐप्लिकेशन को Apple App Store में पब्लिश किया गया है, तो अपने ऐप्लिकेशन का App Store आईडी डालें. स्टोर आईडी, अंकों वाली एक स्ट्रिंग होती है. यह Apple ऐप स्टोर के हर यूआरएल में शामिल होती है.
7. (ज़रूरी नहीं) अपना टीम आईडी डालें. Apple डेवलपर खाते के दस्तावेज़ में, अपना टीम आईडी ढूंढें देखें. अगर आपको अपने क्लाइंट के लिए App Check की सुविधा चालू करनी है, तो टीम आईडी देना ज़रूरी है.
8. (ज़रूरी नहीं) अपने iOS ऐप्लिकेशन के लिए App Check की सुविधा चालू करें. App Check की सुविधा चालू करने पर, Apple की App Attest सेवा का इस्तेमाल करके यह पुष्टि की जाती है कि आपके OAuth क्लाइंट से मिले OAuth 2.0 अनुरोध असली हैं और आपके ऐप्लिकेशन से मिले हैं. इससे ऐप्लिकेशन के नाम पर धोखाधड़ी होने का जोखिम कम हो जाता है.
9. बनाएं पर क्लिक करें.

आपका क्लाइंट आईडी जनरेट हो जाता है और Google Cloud Console में दिखता है. अनुमति देने वाले रीडायरेक्ट को मैनेज करने के लिए, अपने ऐप्लिकेशन के Info.plist में, रिवर्स क्लाइंट आईडी यूआरएल स्कीम (उदाहरण के लिए, com.googleusercontent.apps.1234567890-abcdef) जोड़ें.

3. Google साइन-इन के बुनियादी इंटिग्रेशन की प्रोसेस पूरी करना

इंक्रीमेंटल स्कोप का अनुरोध करने और Google API को कॉल करने से पहले, Google साइन-इन का बुनियादी इंटिग्रेशन पूरा करें.

1. यह देखना कि कौनसे स्कोप को ऐक्सेस दिया गया है

Google API को कॉल करने से पहले, देखें कि आपके ऐप्लिकेशन को पहले से कौनसे स्कोप दिए गए हैं. इसके लिए, GIDGoogleUser की grantedScopes प्रॉपर्टी का इस्तेमाल करें:

Swift

let driveScope = "https://www.googleapis.com/auth/drive.readonly"
let grantedScopes = user.grantedScopes
if grantedScopes == nil || !grantedScopes!.contains(driveScope) {
  // Request additional Drive scope.
}

Objective-C

NSString *driveScope = @"https://www.googleapis.com/auth/drive.readonly";

// Check if the user has granted the Drive scope
if (![user.grantedScopes containsObject:driveScope]) {
  // request additional drive scope
}

उपयोगकर्ता ने किसी खास स्कोप को अनुमति दी है या नहीं, इसके आधार पर आपको किसी खास इंटरैक्शन के लिए, अतिरिक्त स्कोप का अनुरोध करना पड़ सकता है.

2. ज़्यादा स्कोप का अनुरोध करना

अगर आपको अतिरिक्त स्कोप का अनुरोध करना है, तो उपयोगकर्ता से अपने ऐप्लिकेशन को अतिरिक्त ऐक्सेस देने के लिए कहें. इसके लिए, addScopes:presentingViewController:completion या addScopes:presentingWindow:completion को कॉल करें.

उदाहरण के लिए, किसी उपयोगकर्ता की Drive फ़ाइलों के लिए रीड-ओनली ऐक्सेस का अनुरोध करने के लिए:

Swift

let additionalScopes = ["https://www.googleapis.com/auth/drive.readonly"]
guard let currentUser = GIDSignIn.sharedInstance.currentUser else {
    return ;  /* Not signed in. */
}

currentUser.addScopes(additionalScopes, presenting: self) { signInResult, error in
    guard error == nil else { return }
    guard let signInResult = signInResult else { return }

    // Check if the user granted access to the scopes you requested.
}

Objective-C

NSArray *additionalScopes = @[ @"https://www.googleapis.com/auth/drive.readonly" ];
GIDGoogleUser *currentUser = GIDSignIn.sharedInstance.currentUser;

[currentUser addScopes:additionalScopes
           presentingViewController:self
                         completion:^(GIDSignInResult * _Nullable signInResult,
                                      NSError * _Nullable error) {
    if (error) { return; }
    if (signInResult == nil) { return; }

    // Check if the user granted access to the scopes you requested.
}];

3. नए टोकन के साथ एपीआई कॉल करना

यह पक्का करने के लिए कि आपके Google API कॉल में हमेशा ऐसे ऐक्सेस टोकन अटैच हों जिनकी समयसीमा खत्म न हुई हो, कॉल को refreshTokensIfNeededWithCompletion: ब्लॉक में रैप करें:

Swift

currentUser.refreshTokensIfNeeded { user, error in
    guard error == nil else { return }
    guard let user = user else { return }

    // Get the access token to attach it to a REST or gRPC request.
    let accessToken = user.accessToken.tokenString

    // Or, get an object that conforms to GTMFetcherAuthorizationProtocol for
    // use with GTMAppAuth and the Google APIs client library.
    let authorizer = user.fetcherAuthorizer()
}

Objective-C

[currentUser refreshTokensIfNeededWithCompletion:^(
                              GIDGoogleUser * _Nullable user,
                              NSError * _Nullable error) {
    if (error) { return; }
    if (user == nil) { return; }

    // Get the access token to attach it to a REST or gRPC request.
    NSString *accessToken = user.accessToken.tokenString;

    // Or, get an object that conforms to GTMFetcherAuthorizationProtocol for
    // use with GTMAppAuth and the Google APIs client library.
    id<GTMFetcherAuthorizationProtocol> authorizer = [user fetcherAuthorizer];
}];

एपीआई को कॉल करने के लिए, ऐक्सेस टोकन का इस्तेमाल करें. इसके लिए, ऐक्सेस टोकन को REST या gRPC अनुरोध (Authorization: Bearer ACCESS_TOKEN) के हेडर में शामिल करें या Google API क्लाइंट लाइब्रेरी के साथ फ़ेचर ऑथराइज़र का इस्तेमाल करें.