Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

REST API로 동적 링크 생성

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

https://example.page.link/WXYZ

API 및 클라이언트(Android/Apple) SDK로 생성된 짧은 동적 링크는 Firebase 콘솔에 표시되지 않습니다. 이러한 동적 링크는 사용자 간 공유를 위한 것입니다. 마케팅 사용 사례의 경우 계속해서 Firebase 콘솔의 동적 링크 페이지 를 통해 직접 링크를 만드세요.

시작하기 전에

  1. API 키를 가져옵니다. API에 대한 요청을 인증하려면 API 키가 필요합니다. API 키를 찾으려면:
    1. Firebase 콘솔의 설정 페이지 를 엽니다. 프로젝트를 선택하라는 메시지가 표시되면 메뉴에서 Firebase 프로젝트를 선택합니다.
    2. Web API Key 필드의 값을 기록해 두십시오.
  2. Firebase 콘솔에서 동적 링크 섹션을 엽니다.
  3. 아직 서비스 약관에 동의하지 않고 동적 링크에 대한 도메인을 설정하지 않은 경우 메시지가 표시되면 동의하십시오.

    동적 링크 도메인이 이미 있는 경우 기록해 두십시오. 프로그래밍 방식으로 동적 링크를 만들 때 동적 링크 도메인을 제공해야 합니다.

Firebase Dynamic Links API를 사용하여 긴 동적 링크를 줄일 수 있습니다. 이렇게 하려면 longDynamicLink 매개변수에 긴 동적 링크를 지정하여 shortLinks 엔드포인트에 HTTP POST 요청을 수행하십시오. 예를 들어:

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 구성을 참조하세요.

동적 링크 매개변수를 직접 지정하여 짧은 동적 링크를 생성할 수도 있습니다. 이렇게 하려면 dynamicLinkInfo 매개변수에 동적 링크 매개변수를 지정하여 shortLinks 끝점에 HTTP POST 요청을 수행합니다. 예를 들어:

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

이러한 문자열은 임의로 생성된 96비트 숫자를 base62로 인코딩하여 생성됩니다. 이 설정을 사용하면 의도하지 않은 수신자에게 민감한 정보가 노출될 수 있는 동적 링크 URL이 추측 및 크롤링되는 것을 방지할 수 있습니다.

매개변수를 "SHORT" 로 설정하면 경로 구성요소는 최소 길이가 4자인 고유해야 할 만큼만 긴 문자열이 됩니다.

https://example.page.link/WXYZ

짧은 동적 링크 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과 함께 실패합니다.

다음 단계

이제 동적 링크를 만들었으므로 동적 링크를 수신하고 사용자가 링크를 연 후 사용자를 앱의 올바른 위치로 보내도록 앱을 설정해야 합니다.

앱에서 동적 링크를 수신하려면 iOS , Android , C++Unity 설명서를 참조하세요.

요청은 5개/IP 주소/초 및 200,000개/일로 제한됩니다. 초과하면 응답에서 HTTP 오류 코드 429를 반환합니다. 추가 할당량을 요청하려면 이 양식 을 작성하십시오.