ย้ายข้อมูลไปยัง Go Admin SDK v4

ตั้งแต่เวอร์ชัน 4.0.0 เป็นต้นไป Firebase Admin SDK สำหรับ Go ได้เลือกใช้โมดูล 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@v4.23.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 ที่ส่งผลต่อการทำงานอื่นๆ

การเปลี่ยนแปลงการจัดการข้อผิดพลาดทั่วไป

SDK v4 มีแพ็กเกจ errorutils ใหม่ที่ให้ฟังก์ชันสำหรับการจัดการเงื่อนไขข้อผิดพลาดระดับแพลตฟอร์ม ในกรณีที่ข้อผิดพลาดเกิดจากข้อผิดพลาดของบริการแบ็กเอนด์ คุณสามารถเข้าถึงการตอบกลับข้อผิดพลาดเดิมได้โดยเรียกใช้ฟังก์ชันใหม่ errorutils.HTTPResponse() คุณสามารถใช้ฟังก์ชันในแพ็กเกจนี้กับข้อผิดพลาดที่แสดงผลโดย API ใดก็ได้ใน SDK

การเปลี่ยนแปลง API ของ Authentication

  • เพิ่มฟังก์ชันการจัดการข้อผิดพลาดใหม่เพื่อใช้ร่วมกับ API VerifyIDToken() และ VerifySessionCookie() ดังนี้
    • IsIDTokenInvalid()
    • IsIDTokenExpired()
    • IsSessionCookieInvalid()
    • IsSessionCookieExpired()
    • IsCertificateFetchFailed()
  • เลิกใช้งาน:
    • IsProjectNotFound()
    • IsUnknown()
    • IsInsufficientPermission()
    • IsInvalidEmail()

การเปลี่ยนแปลง API ของ FCM

  • เปลี่ยนชื่อประเภท messaging.WebpushFCMOptions เป็น messaging.WebpushFcmOptions แล้ว
  • เพิ่มแล้ว:
    • IsThirdPartyAuthError()
    • IsQuotaExceeded()
    • IsSenderIDMismatch()
    • IsUnregistered()
    • IsUnavailable()
  • เลิกใช้งาน:
    • IsInvalidAPNSCredentials()
    • IsMessageRateExceeded()
    • IsMismatchedCredential()
    • IsRegistrationTokenNotRegistered()
    • IsServerUnavailable()
    • IsTooManyTopics()
    • IsUnknown()

การเปลี่ยนแปลง IID API

ฟังก์ชันการจัดการข้อผิดพลาดทั้งหมดที่มีอยู่ในแพ็กเกจ iid เลิกใช้งานแล้ว ให้ใช้ฟังก์ชันการจัดการข้อผิดพลาดที่เกี่ยวข้องซึ่งมีให้ในแพ็กเกจ errorutils แทน