Go के लिए Firebase Admin SDK टूल के वर्शन 4.0.0 से, Go मॉड्यूल का इस्तेमाल किया जा सकेगा. इसके अलावा, गड़बड़ी की जानकारी की सेटिंग और सिमैंटिक्स में भी बड़े बदलाव किए गए हैं.
इंस्टॉल करने से जुड़े बदलाव
मॉड्यूल के सबसे सही तरीकों के मुताबिक, SDK टूल के मुख्य वर्शन को पैकेज के नाम में जोड़ा गया है. इस बदलाव की वजह से, पैकेज के नाम में ये अपडेट हुए हैं:
- 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
मॉड्यूल का इस्तेमाल करने वाले डेवलपर
SDK टूल का नया वर्शन इंस्टॉल करने के लिए, वर्शन वाले पैकेज के नाम का इस्तेमाल करें.
# 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.20.0
SDK टूल इंपोर्ट करते समय, सोर्स कोड में वर्शन वाले उसी पैकेज के नाम का इस्तेमाल करना होगा.
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
फ़िलहाल, मॉड्यूल का इस्तेमाल न करने वाले डेवलपर
जिन डेवलपर ने अब तक मॉड्यूल का इस्तेमाल शुरू नहीं किया है वे वर्शन के बिना वाले पैकेज के नाम का इस्तेमाल करके, SDK टूल इंस्टॉल कर सकते हैं.
go get firebase.google.com/go
हालांकि, ध्यान दें कि इससे SDK टूल का नया वर्शन (v4 या इसके बाद का वर्शन) फ़ेच होता है. इसमें एपीआई में अन्य बड़े बदलाव किए गए हैं.
गड़बड़ी की जानकारी की सेटिंग में सामान्य बदलाव
v4 SDK टूल में, errorutils नाम का नया पैकेज जोड़ा गया है. इसमें प्लैटफ़ॉर्म-लेवल की गड़बड़ी की स्थितियों को मैनेज करने के लिए फ़ंक्शन दिए गए हैं. अगर बैकएंड सेवा में गड़बड़ी की वजह से कोई गड़बड़ी हुई है, तो errorutils.HTTPResponse() नाम के नए फ़ंक्शन को कॉल करके, गड़बड़ी के ओरिजनल जवाब को ऐक्सेस किया जा सकता है. इस पैकेज में मौजूद फ़ंक्शन का इस्तेमाल, SDK टूल में मौजूद किसी भी एपीआई से मिली गड़बड़ियों के साथ किया जा सकता है.
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 पैकेज में दिए गए, गड़बड़ी की जानकारी की सेटिंग से जुड़े फ़ंक्शन का इस्तेमाल करें.