iOS और macOS के लिए Google साइन-इन की सुविधा शुरू करना

अपने iOS या macOS ऐप्लिकेशन को 'Google साइन इन' कॉम्पोनेंट के साथ इंटिग्रेट करने से पहले, आपको डिपेंडेंसी डाउनलोड करनी होंगी और अपना Xcode प्रोजेक्ट कॉन्फ़िगर करना होगा. इस पेज पर बताया गया तरीका ऐसा ही करता है. इसके बाद, अगले चरण में, 'Google साइन इन' सुविधाओं को अपने ऐप्लिकेशन में इंटिग्रेट करने का तरीका बताया गया है.

शुरू करने से पहले

Xcode का मौजूदा वर्शन इंस्टॉल करें.

अपने प्रोजेक्ट में 'Google साइन इन' डिपेंडेंसी इंस्टॉल करना

कोकोपॉड

1. अगर आपने पहले से CocoaPods इंस्टॉल नहीं किया है, तो CocoaPods का इस्तेमाल शुरू करने के लिए गाइड में दिए गए निर्देशों का पालन करें.

2. कोई टर्मिनल विंडो खोलें और अपने ऐप्लिकेशन के Xcode प्रोजेक्ट की जगह पर जाएं.

3. अगर आपने अपने ऐप्लिकेशन के लिए पहले से Podfile नहीं बनाई है, तो इसे अभी बनाएं:

   pod init

4. आपके ऐप्लिकेशन के लिए बनाई गई Podfile खोलें और उसमें यह जोड़ें:

   pod 'GoogleSignIn'

5. अगर आप SwiftUI का इस्तेमाल कर रहे हैं, तो "Google से साइन इन करें" बटन के लिए पॉड एक्सटेंशन भी जोड़ें:

   pod 'GoogleSignInSwiftSupport'

6. फ़ाइल सेव करें और चलाएं:

   pod install

7. अपने ऐप्लिकेशन के लिए जनरेट की गई .xcworkspace workspace फ़ाइल को Xcode में खोलें. अपने ऐप्लिकेशन में भविष्य के विकास के लिए इस फ़ाइल का इस्तेमाल करें. (ध्यान दें कि यह शामिल की गई .xcodeproj प्रोजेक्ट फ़ाइल से अलग है, जिसे खोलने पर बिल्ड में गड़बड़ियां होंगी.)

   उदाहरण के लिए, आप Objective-C सैंपल ऐप्लिकेशन का Podfile देख सकते हैं.

Swift पैकेज मैनेजर

1. अपना प्रोजेक्ट Xcode में खोलें.

2. अपने ऐप्लिकेशन में, 'Google साइन इन' से जुड़ी डिपेंडेंसी जोड़ें (Xcode दस्तावेज़):

   डेटा स्टोर करने की जगह	https://github.com/google/GoogleSignIn-iOS
   वर्शन	6.0.2
   पैकेज प्रॉडक्ट	Googleसाइन इन

3. अगर आप SwiftUI का इस्तेमाल कर रहे हैं, तो आप "Google से साइन इन करें" बटन के लिए, नीचे दिए गए एक्सटेंशन पैकेज के प्रॉडक्ट को भी जोड़ें:

   पैकेज प्रॉडक्ट

   GoogleSignInSwift

OAuth क्लाइंट आईडी पाएं

आपके ऐप्लिकेशन की पुष्टि Google के पुष्टि बैकएंड में करने के लिए, OAuth क्लाइंट आईडी की ज़रूरत होती है. iOS और macOS ऐप्लिकेशन के लिए, OAuth क्लाइंट आईडी ऐप्लिकेशन टाइप को iOS के तौर पर कॉन्फ़िगर करना ज़रूरी है.

अगर आपने पहले से कोई OAuth क्लाइंट आईडी नहीं बनाया है, तो नीचे दिए गए बटन पर क्लिक करके ऐसा करें.

OAuth क्लाइंट आईडी बनाना

OAuth क्लाइंट आईडी बनाने के बाद, क्लाइंट आईडी स्ट्रिंग पर ध्यान दें. आपको अपने ऐप्लिकेशन में 'Google साइन इन' को कॉन्फ़िगर करना होगा. आप चाहें, तो कॉन्फ़िगरेशन फ़ाइल डाउनलोड की जा सकती है. इस फ़ाइल में, आपका क्लाइंट आईडी और कॉन्फ़िगरेशन से जुड़ा अन्य डेटा होता है.

अगर आपने पहले से ही एक OAuth क्लाइंट आईडी बना लिया है, तो नीचे दिए गए बटन पर क्लिक करके अपनी मौजूदा OAuth जानकारी पाएं.

मौजूदा OAuth क्लाइंट आईडी पाना

OAuth सर्वर क्लाइंट आईडी पाएं

ज़्यादातर ऐप्लिकेशन को साइन-इन किए हुए उपयोगकर्ताओं को किसी तरह की बैकएंड सेवा देने के लिए कहा जाएगा. Google से साइन इन करने वाले उपयोगकर्ताओं की पहचान आपके बैकएंड पर सुरक्षित तरीके से भेजने के लिए, आपको आईडी बैकएंड टोकन का इस्तेमाल करना होगा. इसके बारे में बैकएंड सर्वर से पुष्टि करें में बताया गया है. उपयोगकर्ता का आईडी टोकन वापस पाने के लिए, दूसरे क्लाइंट आईडी की ज़रूरत होती है. यह आपका सर्वर क्लाइंट आईडी होता है, जो आपके बैकएंड के बारे में बताता है.

सर्वर क्लाइंट आईडी बनाने के लिए:

1. अपना प्रोजेक्ट Cloud Console में खोलें.

2. एक नया वेब ऐप्लिकेशन टाइप वाला OAuth क्लाइंट आईडी बनाएं. क्लाइंट आईडी स्ट्रिंग पर ध्यान दें, आपको अपने ऐप्लिकेशन में 'Google साइन इन' को कॉन्फ़िगर करना होगा.

अपना ऐप्लिकेशन प्रोजेक्ट कॉन्फ़िगर करें

'Google साइन-इन' के लिए यह ज़रूरी है कि आपका प्रोजेक्ट आपके OAuth क्लाइंट आईडी और एक कस्टम यूआरएल स्कीम के साथ कॉन्फ़िगर किया जाए. इसके अलावा, अपने सर्वर क्लाइंट आईडी को बैकएंड ऑथेंटिकेशन के लिए भी जोड़ा जा सकता है. इसके अलावा, अपने ऐप्लिकेशन को Google Workspace डोमेन के लिए ऑप्टिमाइज़ भी किया जा सकता है.

अपना OAuth क्लाइंट आईडी और कस्टम यूआरएल स्कीम जोड़ना

अपना OAuth क्लाइंट आईडी और रिवर्स क्लाइंट आईडी के हिसाब से कस्टम यूआरएल स्कीम जोड़ने के लिए, अपने ऐप्लिकेशन की Info.plist फ़ाइल अपडेट करें.

रिवर्स क्लाइंट आईडी आपका क्लाइंट आईडी है, जिसमें डॉट-डीलिमिटेड फ़ील्ड के क्रम को उलटा जाता है. इसे iOS यूआरएल स्कीम" में तब भी दिखाया जाता है, जब Cloud Console में कोई मौजूदा iOS OAuth क्लाइंट चुना जाता है. उदाहरण के लिए: com.googleusercontent.apps.1234567890-abcdefg

<key>GIDClientID</key>
<string>YOUR_IOS_CLIENT_ID</string>
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
    </array>
  </dict>
</array>

ज़रूरी नहीं: बैकएंड की पुष्टि करने की सुविधा कॉन्फ़िगर करें

अगर आपको बैकएंड की पुष्टि करने के लिए, उपयोगकर्ताओं के आईडी टोकन चाहिए, तो अपने ऐप्लिकेशन की Info.plist फ़ाइल में भी GIDServerClientID कुंजी सेट करें.

ध्यान दें: यह आपके बैकएंड प्रोजेक्ट के लिए OAuth क्लाइंट आईडी है, न कि आपके iOS या macOS ऐप्लिकेशन का आईडी. आपको OAuth सर्वर क्लाइंट आईडीपाकर, उसे यहां तय करना होगा.

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

ज़रूरी नहीं: Google Workspace डोमेन या OpenSSL रेल्म के लिए Optimize

अगर आपको Google Workspace डोमेन के लिए साइन-इन फ़्लो को ऑप्टिमाइज़ करना है, तो GIDHostedDomain पैरामीटर का इस्तेमाल करें.

<key>GIDHostedDomain</key>
<string>YOUR_HOSTED_DOMAIN</string>

अगर आपको ओडीएफ़ का दायरा तय करना है, तो GIDOpenIDRealm पैरामीटर का इस्तेमाल करें.

<key>GIDOpenIDRealm</key>
<string>YOUR_OPENID_REALM</string>

आपके आवेदन पर हस्ताक्षर करना

आपके ऐप्लिकेशन को Apple से जारी किए गए सर्टिफ़िकेट के साथ साइन इन करना ज़रूरी है. यह सर्टिफ़िकेट macOS और iOS डिवाइसों पर काम करता है, ताकि कीचेन के ज़रिए क्रेडेंशियल सेव किए जा सकें.

अगले चरण

आपने प्रोजेक्ट डिपेंडेंसी डाउनलोड कर ली हैं और Xcode प्रोजेक्ट को कॉन्फ़िगर कर लिया है. अब iOS ऐप्लिकेशन में Google साइन इन की सुविधा जोड़ी जा सकती है.