בשילובים קיימים שמשתמשים ב-Venor API של Tenor, צריך לפעול לפי השלבים המפורטים בדף הזה כדי לעבור ל-V2.
קניית מפתח V2 API
פועלים לפי ההוראות בשלב ההגדרה של המדריך למתחילים כדי לקבל מפתח API של V2 שיחליף את גרסת V1 שלך.
עדכון לדומיינים מסוג V2
יש לעדכן את דומיין ה-API שלך ל-https://tenor.googleapis.com/v2/
. ב-Venor V2 API יש תמיכה רק בחיבורי 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>
.
שינויים בנקודת קצה (endpoint)
רוב הפרמטרים של נקודת הקצה ל-API לא משתנים מאלה שמתועדים בגרסה 1. קיימים מספר יוצאים מן הכלל:
- בשלב הזה, נקודת הקצה לחיפוש של Tenor תומכת בחיפוש סטיקרים באמצעות הפרמטר
searchfilter
. - יש לכלול את הפרמטרים
client_key
ו-country
בקריאות ל-API. - הפרמטר
media_filter
מקבל עכשיו רשימה מופרדת בפסיקים של הפורמטים הרצויים במקום טיפוסים בני מנייה מוגדרים מראש. - נקודת הקצה של הקטגוריות עכשיו תומכת ב-
featured
וב-trending
בפרמטרtype
. - ה-API כבר לא תומך בפרמטר
anon_id
. - כשאין עוד דפי תוצאות לבקשה, השדה
next
של התשובות ב-API הוא עכשיו מחרוזת ריקה במקום"0"
.
השינויים הבאים בוצעו לנקודות הקצה:
- אין יותר תמיכה בנקודת הקצה של 'הסרטונים החמים'. במקום זאת, מומלץ להשתמש בנקודת הקצה שמוצגת.
- נקודת הקצה ל-GIF עברה מיתוג מחדש כנקודת הקצה של פוסטים.
- נקודת הקצה GIF אקראית שולבה בנקודת הקצה לחיפוש באמצעות הפרמטר
random
.
אובייקט התשובה ושינויים בשגיאות
- אובייקט GIF מותג מחדש כאובייקט תגובה.
- באובייקט התגובה, השדה
media
מותג מחדש כ-media_formats
. הערך שלmedia_formats
הוא כעת מפה{ CONTENT_FORMAT : MEDIA_OBJECT }
ולא מערך של מפות. - התצוגות המקדימות של התמונות הממוזערות של התוכן הועברו מאובייקט המדיה של כל פורמט תוכן לפורמט משלו. הן מוצעות בשדה
media_formats
באובייקט התשובה. - אם אין יותר תוצאות באובייקט תגובה, השדה
next
הוא מחרוזת ריקה,""
ולא"0"
. - קודי השגיאות של Tenor API הועברו לקודי השגיאה הרגילים של Google API.