Google is committed to advancing racial equity for Black communities. See how.
דף זה תורגם על ידי Cloud Translation API.
Switch to English

צור קישורים דינמיים עם ממשק ה- REST

אתה יכול ליצור קישורים דינמיים קצרים עם ממשק API REST של קישורים דינמיים של Firebase. ממשק API זה מקבל קישור דינאמי ארוך או אובייקט המכיל פרמטרים של קישור דינמי ומחזיר כתובת URL כדוגמה הבאה:

https://example.page.link/WXYZ

קישורים דינמיים קצרים שנוצרו עם ממשק API ולקוח (Android / iOS) SDK אינם מופיעים במסוף האש. קישורים דינמיים מסוג זה מיועדים לשיתוף משתמש-למשתמש. במקרים של שימוש בשיווק, המשך ליצור את הקישורים שלך ישירות דרך דף קישורים דינמיים במסוף האש.

לפני שאתה מתחיל

  1. קבל את מפתח ה- API שלך. תזדקק למפתח API כדי לאמת את בקשותיך לממשק ה- API. כדי למצוא את מפתח ה- API שלך:
    1. פתח את דף ההגדרות במסוף האש. אם תתבקש לבחור פרויקט, בחר בפרויקט Firebase שלך ​​מהתפריט.
    2. שימו לב לערך של שדה מפתח ה- API .
  2. במסוף Firebase, פתח את החלק קישורים דינמיים .
  3. אם עדיין לא הסכמת לתנאי השירות והגדרת דומיין לקישורים הדינמיים שלך, עשה זאת כאשר תתבקש.

    אם כבר יש לך תחום קישורים דינמיים, שימו לב לכך. עליך לספק תחום קישורים דינמיים כאשר אתה יוצר באופן תכנותי קישורים דינמיים.

אתה יכול להשתמש בממשק ה- API של Firebase Links Dynamic כדי לקצר קישור דינאמי ארוך. לשם כך, shortLinks בקשת HTTP POST shortLinks הקצה של shortLinks , וציין את הקישור הדינמי הארוך בפרמטר longDynamicLink . לדוגמה:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key= api_key
Content-Type: application/json

{
   "longDynamicLink": "https://example.page.link/?link=https://www.example.com/&apn=com.example.android&ibi=com.example.ios"
}

ראה בנה ידנית כתובת URL כדי ללמוד כיצד ליצור קישורים דינמיים ארוכים.

ניתן גם ליצור קישור דינמי קצר על ידי ציון ישירות של הפרמטרים של קישור דינמי. לשם כך, shortLinks בקשת HTTP POST shortLinks הקצה של shortLinks , וציין את הפרמטרים של קישור דינמי בפרמטר dynamicLinkInfo . לדוגמה:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key= api_key
Content-Type: application/json

{
  "dynamicLinkInfo": {
    "domainUriPrefix": "https://example.page.link",
    "link": "https://www.example.com/",
    "androidInfo": {
      "androidPackageName": "com.example.android"
    },
    "iosInfo": {
      "iosBundleId": "com.example.ios"
    }
  }
}

למפרט מלא של אובייקט dynamicLinkInfo , עיין בהפניה לממשק ה- API .

הגדר את האורך של קישור דינמי קצר

ניתן גם להגדיר את פרמטר suffix כדי לציין כיצד נוצר רכיב הנתיב של הקישור הדינמי הקצר.

כברירת מחדל, או אם תגדיר את הפרמטר ל- "UNGUESSABLE" , רכיב הנתיב יהיה מחרוזת בת 17 תווים, כמו בדוגמה הבאה:

https://example.page.link/UVWXYZuvwxyz12345

מיתרים כאלה נוצרים על ידי קידוד base62 מספרים שנוצרו באופן אקראי על 96 סיביות. השתמש בהגדרה זו כדי למנוע ניחוש וסריקה של כתובות האתרים של קישורים דינמיים שלך, מה שעלול לחשוף מידע רגיש לנמענים לא מכוונים.

אם תגדיר את הפרמטר ל- "SHORT" , רכיב הנתיב יהיה מחרוזת שאורכה רק צורך להיות ייחודי, באורך מינימלי של 4 תווים.

https://example.page.link/WXYZ

השתמש בשיטה זו אם מידע רגיש לא ייחשף אם ניחשת כתובת אתר קישור דינאמית קצרה.

הדוגמה הבאה מראה כיצד ניתן להגדיר את פרמטר suffix :

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key= api_key
Content-Type: application/json

{
   "longDynamicLink": "https://example.page.link/?link=http://www.example.com/&apn=com.example.android&ibi=com.example.ios",
   "suffix": {
     "option": "UNGUESSABLE"
   }
}

לכל הפחות, ערך הקישור העמוק שצריך חייב להתחיל עם סכימות http: // או https: //. עליו גם להתאים לכל רשימת תבניות של כתובת אתר שהוזנה במסוף. אחרת, ממשק ה- API ליצירה ייכשל עם קוד שגיאה HTTP 400.

הצעדים הבאים

כעת, לאחר שיצרת קישורים דינמיים, עליך להגדיר את האפליקציה שלך כדי לקבל קישורים דינמיים ולשלוח משתמשים למקום הנכון באפליקציה שלך לאחר שמשתמש יפתח אותם.

כדי לקבל קישורים דינמיים באפליקציה שלך, עיין בתיעוד עבור iOS , Android , C ++ ו- Unity .

הבקשות מוגבלות ל -5 בקשות / כתובת IP / שנייה, ו -200,000 בקשות ביום. אם חריגה, התגובה תחזיר את קוד השגיאה של HTTP 429. לבקשה למכסה נוספת, מלא טופס זה.