Go Admin SDK v4-এ মাইগ্রেট করুন

৪.০.০ সংস্করণ থেকে শুরু করে, Go-এর জন্য Firebase Admin SDK 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.18.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 বা পরবর্তী) আনবে যাতে অন্যান্য ব্রেকিং API পরিবর্তন রয়েছে।

সাধারণ ত্রুটি পরিচালনার পরিবর্তনগুলি

v4 SDK একটি নতুন errorutils প্যাকেজ চালু করেছে যা প্ল্যাটফর্ম-স্তরের ত্রুটির অবস্থা পরিচালনার জন্য ফাংশন প্রদান করে। যদি কোনও ব্যাকএন্ড পরিষেবা ত্রুটির কারণে কোনও ত্রুটি ঘটে থাকে, তাহলে আপনি নতুন ফাংশন errorutils.HTTPResponse() কল করে মূল ত্রুটির প্রতিক্রিয়া অ্যাক্সেস করতে পারেন। আপনি SDK-তে যেকোনো API দ্বারা ফেরত আসা ত্রুটি সহ এই প্যাকেজের ফাংশনগুলি ব্যবহার করতে পারেন।

Authentication API পরিবর্তন

  • VerifyIDToken() এবং VerifySessionCookie() API-এর সাথে ব্যবহার করার জন্য নতুন ত্রুটি পরিচালনা ফাংশন যোগ করা হয়েছে:
    • IsIDTokenInvalid()
    • IsIDTokenExpired()
    • IsSessionCookieInvalid()
    • IsSessionCookieExpired()
    • IsCertificateFetchFailed()
  • অবচিত:
    • IsProjectNotFound()
    • IsUnknown()
    • IsInsufficientPermission()
    • IsInvalidEmail()

FCM API পরিবর্তন

  • messaging.WebpushFCMOptions টাইপের নাম পরিবর্তন করে messaging.WebpushFcmOptions করা হয়েছে।
  • যোগ করা হয়েছে:
    • IsThirdPartyAuthError()
    • IsQuotaExceeded()
    • IsSenderIDMismatch()
    • IsUnregistered()
    • IsUnavailable()
  • অবচিত:
    • IsInvalidAPNSCredentials()
    • IsMessageRateExceeded()
    • IsMismatchedCredential()
    • IsRegistrationTokenNotRegistered()
    • IsServerUnavailable()
    • IsTooManyTopics()
    • IsUnknown()

আইআইডি এপিআই পরিবর্তন

iid প্যাকেজে বর্তমানে উপলব্ধ সমস্ত ত্রুটি পরিচালনার ফাংশন এখন অবচিত। পরিবর্তে errorutils প্যাকেজে প্রদত্ত সংশ্লিষ্ট ত্রুটি পরিচালনার ফাংশনগুলি ব্যবহার করুন।