이 페이지는 Cloud Translation API를 통해 번역되었습니다.

REST API로 동적 링크 만들기

Firebase Dynamic Links REST API를 사용하여 짧은 Dynamic Links을 만들 수 있습니다. 이 API 긴 Dynamic Link 또는 Dynamic Link 매개변수가 포함된 객체를 허용합니다. 은 다음 예와 같은 URL을 반환합니다.

https://example.page.link/WXYZ

API 및 클라이언트(Android/Apple) SDK로 만든 짧은 Dynamic Links이(가) 표시되지 않음 Firebase 콘솔에서 확인할 수 있습니다. 이러한 Dynamic Links는 사용자 간 공유를 위한 것입니다. 마케팅 사용 사례의 경우 계속해서 Dynamic Links 페이지 (Firebase 콘솔).

시작하기 전에

API 키를 확인합니다. API 요청을 인증하려면 API 키가 필요합니다. API 키를 확인하는 방법은 다음과 같습니다.
1. 설정 페이지를 엽니다. Firebase 콘솔의 화면입니다. 프로젝트를 선택하라는 메시지가 나타나면 메뉴에서 Firebase 프로젝트를 선택합니다.
2. 웹 API 키 필드의 값을 기록해 둡니다.
Firebase 콘솔에서 Dynamic Links 섹션을 엽니다.
아직 서비스 약관에 동의하지 않았으며 도메인을 설정하지 않은 경우 메시지가 표시되면 Dynamic Links에 설정하세요.

Dynamic Links 도메인이 이미 있으면 기록해 둡니다. 해야 할 일 프로그래매틱 방식으로 Dynamic Links를 만들 때 Dynamic Links 도메인을 제공해야 합니다.

짧은 Dynamic Link 만들기

긴 링크로 짧은 링크 만들기

Firebase Dynamic Links API를 사용하여 긴 Dynamic Link을 단축할 수 있습니다. 이렇게 하려면 shortLinks 엔드포인트에 HTTP POST 요청을 실행하여 longDynamicLink 매개변수의 긴 Dynamic Link 예를 들면 다음과 같습니다.

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 작성을 참조하세요. 이렇게 하면 긴 Dynamic Links을 만들 수 있습니다.

매개변수로 짧은 링크 만들기

Dynamic Link 매개변수를 지정하여 짧은 Dynamic Link를 만들 수도 있습니다. 할 수 있습니다. 이렇게 하려면 shortLinks에 HTTP POST 요청을 실행합니다. 엔드포인트로, dynamicLinkInfo 매개변수에 Dynamic Link 매개변수를 지정합니다. 예를 들면 다음과 같습니다.

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 참조를 확인하세요.

짧은 Dynamic Link의 길이를 설정합니다.

suffix 매개변수를 설정하여 짧은 Dynamic Link가 생성됩니다.

기본적으로, 또는 매개변수를 "UNGUESSABLE"로 설정하면 경로 구성요소가 다음 예시와 같이 17자(영문 기준) 길이로 생성됩니다.

https://example.page.link/UVWXYZuvwxyz12345

이러한 문자열은 base62 인코딩으로 무작위 생성된 96비트 숫자로 만들어집니다. 이 설정을 사용하면 Dynamic Links URL이 추측 및 크롤링되지 않도록 방지할 수 있습니다. 의도하지 않은 수신자에게 민감한 정보가 노출될 수 있습니다

매개변수를 "SHORT"로 설정하면 경로 구성요소가 고유성을 유지하는 데 필요한 최소한의 길이로 생성되며 최소 길이는 4자입니다.

https://example.page.link/WXYZ

짧은 Dynamic Link URL이 추측되었습니다.

다음 예시에서는 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:// 스키마로 시작되어야 합니다. 또한 콘솔에 입력한 URL 패턴 허용 목록과도 일치해야 합니다. 그렇지 않을 경우 생성 API가 실패하고 HTTP 오류 코드 400이 반환됩니다.

다음 단계

이제 Dynamic Links를 만들었으므로 앱을 설정하여 Dynamic Links하고 사용자가 앱을 연 후 앱의 적절한 위치로 사용자를 안내합니다.

앱에서 Dynamic Links를 수신하려면 다음 문서를 참고하세요. iOS, Android C++, Unity에서 사용할 수 있습니다.

요청은 IP 주소별 초당 5회, 일일 200,000회로 제한됩니다. 한도를 초과하면 응답에 HTTP 오류 코드 429가 반환됩니다. 할당량 증가를 요청하려면 이 양식을 작성하세요.