Home | History | Annotate | Download | only in dyn
      1 <html><body>
      2 <style>
      3 
      4 body, h1, h2, h3, div, span, p, pre, a {
      5   margin: 0;
      6   padding: 0;
      7   border: 0;
      8   font-weight: inherit;
      9   font-style: inherit;
     10   font-size: 100%;
     11   font-family: inherit;
     12   vertical-align: baseline;
     13 }
     14 
     15 body {
     16   font-size: 13px;
     17   padding: 1em;
     18 }
     19 
     20 h1 {
     21   font-size: 26px;
     22   margin-bottom: 1em;
     23 }
     24 
     25 h2 {
     26   font-size: 24px;
     27   margin-bottom: 1em;
     28 }
     29 
     30 h3 {
     31   font-size: 20px;
     32   margin-bottom: 1em;
     33   margin-top: 1em;
     34 }
     35 
     36 pre, code {
     37   line-height: 1.5;
     38   font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
     39 }
     40 
     41 pre {
     42   margin-top: 0.5em;
     43 }
     44 
     45 h1, h2, h3, p {
     46   font-family: Arial, sans serif;
     47 }
     48 
     49 h1, h2, h3 {
     50   border-bottom: solid #CCC 1px;
     51 }
     52 
     53 .toc_element {
     54   margin-top: 0.5em;
     55 }
     56 
     57 .firstline {
     58   margin-left: 2 em;
     59 }
     60 
     61 .method  {
     62   margin-top: 1em;
     63   border: solid 1px #CCC;
     64   padding: 1em;
     65   background: #EEE;
     66 }
     67 
     68 .details {
     69   font-weight: bold;
     70   font-size: 14px;
     71 }
     72 
     73 </style>
     74 
     75 <h1><a href="firebasedynamiclinks_v1.html">Firebase Dynamic Links API</a> . <a href="firebasedynamiclinks_v1.shortLinks.html">shortLinks</a></h1>
     76 <h2>Instance Methods</h2>
     77 <p class="toc_element">
     78   <code><a href="#create">create(body, x__xgafv=None)</a></code></p>
     79 <p class="firstline">Creates a short Dynamic Link given either a valid long Dynamic Link or</p>
     80 <h3>Method Details</h3>
     81 <div class="method">
     82     <code class="details" id="create">create(body, x__xgafv=None)</code>
     83   <pre>Creates a short Dynamic Link given either a valid long Dynamic Link or
     84 details such as Dynamic Link domain, Android and iOS app information.
     85 The created short Dynamic Link will not expire.
     86 
     87 Repeated calls with the same long Dynamic Link or Dynamic Link information
     88 will produce the same short Dynamic Link.
     89 
     90 The Dynamic Link domain in the request must be owned by requester's
     91 Firebase project.
     92 
     93 Args:
     94   body: object, The request body. (required)
     95     The object takes the form of:
     96 
     97 { # Request to create a short Dynamic Link.
     98     "dynamicLinkInfo": { # Information about a Dynamic Link. # Information about the Dynamic Link to be shortened.
     99         # [Learn more](https://firebase.google.com/docs/dynamic-links/android#create-a-dynamic-link-programmatically).
    100       "navigationInfo": { # Information of navigation behavior. # Information of navigation behavior of a Firebase Dynamic Links.
    101         "enableForcedRedirect": True or False, # If this option is on, FDL click will be forced to redirect rather than
    102             # show an interstitial page.
    103       },
    104       "analyticsInfo": { # Tracking parameters supported by Dynamic Link. # Parameters used for tracking. See all tracking parameters in the
    105           # [documentation](https://firebase.google.com/docs/dynamic-links/create-manually).
    106         "googlePlayAnalytics": { # Parameters for Google Play Campaign Measurements. # Google Play Campaign Measurements.
    107             # [Learn more](https://developers.google.com/analytics/devguides/collection/android/v4/campaigns#campaign-params)
    108           "utmMedium": "A String", # Campaign medium; used to identify a medium such as email or cost-per-click.
    109           "utmSource": "A String", # Campaign source; used to identify a search engine, newsletter, or other
    110               # source.
    111           "gclid": "A String", # [AdWords autotagging parameter](https://support.google.com/analytics/answer/1033981?hl=en);
    112               # used to measure Google AdWords ads. This value is generated dynamically
    113               # and should never be modified.
    114           "utmTerm": "A String", # Campaign term; used with paid search to supply the keywords for ads.
    115           "utmContent": "A String", # Campaign content; used for A/B testing and content-targeted ads to
    116               # differentiate ads or links that point to the same URL.
    117           "utmCampaign": "A String", # Campaign name; used for keyword analysis to identify a specific product
    118               # promotion or strategic campaign.
    119         },
    120         "itunesConnectAnalytics": { # Parameters for iTunes Connect App Analytics. # iTunes Connect App Analytics.
    121           "mt": "A String", # iTune media types, including music, podcasts, audiobooks and so on.
    122           "at": "A String", # Affiliate token used to create affiliate-coded links.
    123           "pt": "A String", # Provider token that enables analytics for Dynamic Links from within iTunes
    124               # Connect.
    125           "ct": "A String", # Campaign text that developers can optionally add to any link in order to
    126               # track sales from a specific marketing campaign.
    127         },
    128       },
    129       "iosInfo": { # iOS related attributes to the Dynamic Link.. # iOS related information. See iOS related parameters in the
    130           # [documentation](https://firebase.google.com/docs/dynamic-links/create-manually).
    131         "iosCustomScheme": "A String", # Custom (destination) scheme to use for iOS. By default, well use the
    132             # bundle ID as the custom scheme. Developer can override this behavior using
    133             # this param.
    134         "iosFallbackLink": "A String", # Link to open on iOS if the app is not installed.
    135         "iosBundleId": "A String", # iOS bundle ID of the app.
    136         "iosIpadBundleId": "A String", # iPad bundle ID of the app.
    137         "iosAppStoreId": "A String", # iOS App Store ID.
    138         "iosIpadFallbackLink": "A String", # If specified, this overrides the ios_fallback_link value on iPads.
    139       },
    140       "androidInfo": { # Android related attributes to the Dynamic Link. # Android related information. See Android related parameters in the
    141           # [documentation](https://firebase.google.com/docs/dynamic-links/create-manually).
    142         "androidFallbackLink": "A String", # Link to open on Android if the app is not installed.
    143         "androidPackageName": "A String", # Android package name of the app.
    144         "androidLink": "A String", # If specified, this overrides the link parameter on Android.
    145         "androidMinPackageVersionCode": "A String", # Minimum version code for the Android app. If the installed apps version
    146             # code is lower, then the user is taken to the Play Store.
    147       },
    148       "socialMetaTagInfo": { # Parameters for social meta tag params. # Parameters for social meta tag params.
    149           # Used to set meta tag data for link previews on social sites.
    150           # Used to set meta tag data for link previews on social sites.
    151         "socialTitle": "A String", # Title to be displayed. Optional.
    152         "socialDescription": "A String", # A short description of the link. Optional.
    153         "socialImageLink": "A String", # An image url string. Optional.
    154       },
    155       "link": "A String", # The link your app will open, You can specify any URL your app can handle.
    156           # This link must be a well-formatted URL, be properly URL-encoded, and use
    157           # the HTTP or HTTPS scheme. See 'link' parameters in the
    158           # [documentation](https://firebase.google.com/docs/dynamic-links/create-manually).
    159           #
    160           # Required.
    161       "dynamicLinkDomain": "A String", # Dynamic Links domain that the project owns, e.g. abcd.app.goo.gl
    162           # [Learn more](https://firebase.google.com/docs/dynamic-links/android/receive)
    163           # on how to set up Dynamic Link domain associated with your Firebase project.
    164           #
    165           # Required.
    166     },
    167     "longDynamicLink": "A String", # Full long Dynamic Link URL with desired query parameters specified.
    168         # For example,
    169         # "https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample",
    170         # [Learn more](https://firebase.google.com/docs/dynamic-links/android#create-a-dynamic-link-programmatically).
    171     "suffix": { # Short Dynamic Link suffix. # Short Dynamic Link suffix. Optional.
    172       "option": "A String", # Suffix option.
    173     },
    174   }
    175 
    176   x__xgafv: string, V1 error format.
    177     Allowed values
    178       1 - v1 error format
    179       2 - v2 error format
    180 
    181 Returns:
    182   An object of the form:
    183 
    184     { # Response to create a short Dynamic Link.
    185     "previewLink": "A String", # Preivew link to show the link flow chart.
    186     "warning": [ # Information about potential warnings on link creation.
    187       { # Dynamic Links warning messages.
    188         "warningCode": "A String", # The warning code.
    189         "warningMessage": "A String", # The warning message to help developers improve their requests.
    190       },
    191     ],
    192     "shortLink": "A String", # Short Dynamic Link value. e.g. https://abcd.app.goo.gl/wxyz
    193   }</pre>
    194 </div>
    195 
    196 </body></html>