วิธีย้ายข้อมูลจาก V1 API ของ Tenor

สำหรับการผสานรวมที่มีอยู่ซึ่งใช้ V1 API ของ Tenor ให้ทำตามขั้นตอนในหน้านี้เพื่อ ย้ายข้อมูลไปยัง V2

รับคีย์ API V2

ทำตามวิธีการในขั้นตอนการตั้งค่าของคู่มือเริ่มใช้งานฉบับย่อเพื่อรับคีย์ API V2 มาแทนที่เวอร์ชัน V1

อัปเดตเป็นโดเมน V2

อัปเดตโดเมน API เป็น https://tenor.googleapis.com/v2/ API V2 ของ Tenor รองรับเฉพาะการเชื่อมต่อ HTTPS สำหรับเนื้อหา โปรดตรวจสอบว่าแอปพลิเคชันของคุณรองรับการดาวน์โหลดเนื้อหาจาก https://media.tenor.com และ https://c.tenor.com

ตัวอย่างเช่น สมมติว่าคุณเรียก API ไปยังโดเมน V1 อย่างใดอย่างหนึ่งต่อไปนี้

  • https://api.tenor.com/v1/search?<parameters>
  • https://g.tenor.com/v1/search?<parameters>

หากต้องการอัปเดตการเรียกไปยัง V2 ให้เปลี่ยนเป็น https://tenor.googleapis.com/v2/search?<parameters>

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

พารามิเตอร์ของปลายทาง API ส่วนใหญ่ยังคงเหมือนกับที่ระบุไว้ใน V1 โดยมีข้อยกเว้นที่สำคัญบางประการ ดังนี้

  1. ตอนนี้ Search endpoint ของ Tenor รองรับการค้นหาสติกเกอร์ผ่านพารามิเตอร์ searchfilter แล้ว
  2. ใส่พารามิเตอร์ client_key และ country ในการเรียก API
  3. ตอนนี้พารามิเตอร์ media_filter จะใช้รายการรูปแบบที่ต้องการซึ่งคั่นด้วยคอมมา แทนที่จะใช้ Enum ที่กำหนดไว้ล่วงหน้า
  4. ตอนนี้ปลายทางหมวดหมู่รองรับ featured และ trending สำหรับพารามิเตอร์ type แล้ว
  5. API ไม่รองรับพารามิเตอร์ anon_id อีกต่อไป
  6. เมื่อไม่มีหน้าผลการค้นหาให้ขออีกต่อไป ฟิลด์ next ของการตอบกลับจาก API จะเป็นสตริงว่างแทน "0"

เราได้ทำการเปลี่ยนแปลงต่อไปนี้กับปลายทางที่พร้อมใช้งาน

  1. ระบบไม่รองรับปลายทางที่กำลังมาแรงอีกต่อไป เราขอแนะนำให้คุณใช้ปลายทางที่แนะนำแทน
  2. เราได้รีแบรนด์ปลายทาง GIF เป็นปลายทางโพสต์แล้ว
  3. เราได้รวมปลายทาง GIF แบบสุ่มเข้ากับปลายทางการค้นหาผ่านพารามิเตอร์ random แล้ว

การเปลี่ยนแปลงออบเจ็กต์การตอบกลับและข้อผิดพลาด

  • เราได้เปลี่ยนชื่อออบเจ็กต์ GIF เป็น ออบเจ็กต์ การตอบกลับ
  • ในออบเจ็กต์ Response Object เราได้เปลี่ยนชื่อฟิลด์ media เป็น media_formats แล้ว ตอนนี้ค่าสำหรับ media_formats เป็นแมป { CONTENT_FORMAT : MEDIA_OBJECT } แทนที่จะเป็นอาร์เรย์ของแมป
  • เราได้ย้ายตัวอย่างภาพขนาดย่อของเนื้อหาจาก ออบเจ็กต์สื่อ สำหรับ เนื้อหา แต่ละรูปแบบไปยังรูปแบบของตัวเองแล้ว โดยจะแสดงในฟิลด์ media_formats ใน ออบเจ็กต์การตอบกลับ
  • เมื่อไม่มีผลลัพธ์เพิ่มเติมในออบเจ็กต์การตอบกลับ ฟิลด์ next จะเป็นสตริงว่าง "" แทนที่จะเป็น "0"
  • เราได้ย้ายรหัสข้อผิดพลาดของ Tenor API ไปยัง API มาตรฐานของ Google รหัสข้อผิดพลาดแล้ว