Go के एडमिन SDK v4 पर माइग्रेट करें

Go के लिए Firebase Admin SDK टूल के वर्शन 4.0.0 से, Go मॉड्यूल का इस्तेमाल किया जा सकेगा. इसके अलावा, गड़बड़ी की जानकारी की सेटिंग और सिमैंटिक्स में भी बड़े बदलाव किए गए हैं.

इंस्टॉल करने से जुड़े बदलाव

मॉड्यूल के सबसे सही तरीकों के मुताबिक, एसडीके के मुख्य वर्शन को पैकेज के नाम में जोड़ा गया है. इस बदलाव से, पैकेज के नाम में ये अपडेट हुए हैं:

  • firebase.google.com/go → firebase.google.com/go/v4
  • firebase.google.com/go/auth → firebase.google.com/go/v4/auth
  • firebase.google.com/go/db → firebase.google.com/go/v4/db
  • firebase.google.com/go/iid → firebase.google.com/go/v4/iid
  • firebase.google.com/go/messaging → firebase.google.com/go/v4/messaging

मॉड्यूल का इस्तेमाल करने वाले डेवलपर

एसडीके का नया वर्शन इंस्टॉल करने के लिए, वर्शन वाले पैकेज के नाम का इस्तेमाल करें.

# Install the latest version:
go install firebase.google.com/go/v4@latest

# Or install a specific version:
go install firebase.google.com/go/v4@4.21.0

एसडीके इंपोर्ट करते समय, सोर्स कोड में वर्शन वाले पैकेज के उसी नाम का इस्तेमाल करना होगा.

package helloworld

import (
        "firebase.google.com/go/v4"
        "firebase.google.com/go/v4/auth"
        "firebase.google.com/go/v4/messaging"
)

पिछला वर्शन इंस्टॉल करने के लिए, वर्शन की जानकारी देने वाले क्वालिफ़ायर के साथ, वर्शन के बिना वाले पुराने पैकेज के नाम का इस्तेमाल करें.

# Notice the @v3 suffix.
# This instructs Go tools to fetch the latest v3.x release of the SDK.
go get firebase.google.com/go@v3

फ़िलहाल, मॉड्यूल का इस्तेमाल न करने वाले डेवलपर

जिन डेवलपर ने अब तक मॉड्यूल का इस्तेमाल शुरू नहीं किया है वे वर्शन के बिना वाले पैकेज के नाम का इस्तेमाल करके, एसडीके इंस्टॉल कर सकते हैं.

go get firebase.google.com/go

हालांकि, ध्यान दें कि इससे एसडीके का नया वर्शन (v4 या इसके बाद का वर्शन) फ़ेच होता है. इसमें एपीआई में अन्य बड़े बदलाव किए गए हैं.

गड़बड़ी की जानकारी की सेटिंग में सामान्य बदलाव

v4 एसडीके में, errorutils नाम का नया पैकेज जोड़ा गया है. इसमें प्लैटफ़ॉर्म-लेवल की गड़बड़ी की स्थितियों को मैनेज करने के लिए फ़ंक्शन दिए गए हैं. अगर बैकएंड सेवा में गड़बड़ी की वजह से कोई गड़बड़ी हुई है, तो errorutils.HTTPResponse() नाम के नए फ़ंक्शन को कॉल करके, गड़बड़ी के ओरिजनल जवाब को ऐक्सेस किया जा सकता है. इस पैकेज में मौजूद फ़ंक्शन का इस्तेमाल, एसडीके में मौजूद किसी भी एपीआई से मिली गड़बड़ियों के साथ किया जा सकता है.

Authentication एपीआई में बदलाव

  • VerifyIDToken() और VerifySessionCookie() एपीआई के साथ इस्तेमाल किए जाने वाले, गड़बड़ी की जानकारी की सेटिंग के नए फ़ंक्शन जोड़े गए हैं:
    • IsIDTokenInvalid()
    • IsIDTokenExpired()
    • IsSessionCookieInvalid()
    • IsSessionCookieExpired()
    • IsCertificateFetchFailed()
  • इन फ़ंक्शन का इस्तेमाल अब नहीं किया जा सकेगा:
    • IsProjectNotFound()
    • IsUnknown()
    • IsInsufficientPermission()
    • IsInvalidEmail()

FCM एपीआई में बदलाव

  • messaging.WebpushFCMOptions टाइप का नाम बदलकर messaging.WebpushFcmOptions कर दिया गया है.
  • ये फ़ंक्शन जोड़े गए हैं:
    • IsThirdPartyAuthError()
    • IsQuotaExceeded()
    • IsSenderIDMismatch()
    • IsUnregistered()
    • IsUnavailable()
  • इन फ़ंक्शन का इस्तेमाल अब नहीं किया जा सकेगा:
    • IsInvalidAPNSCredentials()
    • IsMessageRateExceeded()
    • IsMismatchedCredential()
    • IsRegistrationTokenNotRegistered()
    • IsServerUnavailable()
    • IsTooManyTopics()
    • IsUnknown()

IID एपीआई में बदलाव

iid पैकेज में फ़िलहाल उपलब्ध, गड़बड़ी की जानकारी की सेटिंग के सभी फ़ंक्शन का इस्तेमाल अब नहीं किया जा सकेगा. इसके बजाय, errorutils पैकेज में दिए गए, गड़बड़ी की जानकारी की सेटिंग के मिलते-जुलते फ़ंक्शन का इस्तेमाल करें.