Api-Roll 50: 2017-06-12

discovery/googleapis/firebasedynamiclinks__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/firebase": {
                     "description": "View and administer all your Firebase data and settings"
                 }
             }
         }
     },
     "basePath": "",
     "baseUrl": "https://firebasedynamiclinks.googleapis.com/",
     "batchPath": "batch",
     "canonicalName": "Firebase Dynamic Links",
     "description": "Programmatically creates and manages Firebase Dynamic Links.",
     "discoveryVersion": "v1",
     "documentationLink": "https://firebase.google.com/docs/dynamic-links/",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "firebasedynamiclinks:v1",
     "kind": "discovery#restDescription",
     "name": "firebasedynamiclinks",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
+        "oauth_token": {
+            "description": "OAuth 2.0 token for the current user.",
+            "location": "query",
+            "type": "string"
+        },
+        "bearer_token": {
+            "description": "OAuth bearer token.",
+            "location": "query",
+            "type": "string"
+        },
         "upload_protocol": {
             "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
             "location": "query",
             "type": "string"
         },
         "prettyPrint": {
             "default": "true",
             "description": "Returns response with indentations and line breaks.",
             "location": "query",
             "type": "boolean"
@@ skipping 55 matching lines @@
         "quotaUser": {
             "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
             "location": "query",
             "type": "string"
         },
         "pp": {
             "default": "true",
             "description": "Pretty-print response.",
             "location": "query",
             "type": "boolean"
-        },
-        "bearer_token": {
-            "description": "OAuth bearer token.",
-            "location": "query",
-            "type": "string"
-        },
-        "oauth_token": {
-            "description": "OAuth 2.0 token for the current user.",
-            "location": "query",
-            "type": "string"
         }
     },
     "protocol": "rest",
     "resources": {
+        "v1": {
+            "methods": {
+                "getLinkStats": {
+                    "description": "Fetches analytics stats of a short Dynamic Link for a given\nduration. Metrics include number of clicks, redirects, installs,\napp first opens, and app reopens.",
+                    "httpMethod": "GET",
+                    "id": "firebasedynamiclinks.getLinkStats",
+                    "parameterOrder": [
+                        "dynamicLink"
+                    ],
+                    "parameters": {
+                        "durationDays": {
+                            "description": "The span of time requested in days.",
+                            "format": "int64",
+                            "location": "query",
+                            "type": "string"
+                        },
+                        "dynamicLink": {
+                            "description": "Dynamic Link URL. e.g. https://abcd.app.goo.gl/wxyz",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "v1/{dynamicLink}/linkStats",
+                    "response": {
+                        "$ref": "DynamicLinkStats"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/firebase"
+                    ]
+                }
+            }
+        },
         "shortLinks": {
             "methods": {
                 "create": {
                     "description": "Creates a short Dynamic Link given either a valid long Dynamic Link or\ndetails such as Dynamic Link domain, Android and iOS app information.\nThe created short Dynamic Link will not expire.\n\nRepeated calls with the same long Dynamic Link or Dynamic Link information\nwill produce the same short Dynamic Link.\n\nThe Dynamic Link domain in the request must be owned by requester's\nFirebase project.",
                     "httpMethod": "POST",
                     "id": "firebasedynamiclinks.shortLinks.create",
                     "parameterOrder": [],
                     "parameters": {},
                     "path": "v1/shortLinks",
                     "request": {
                         "$ref": "CreateShortDynamicLinkRequest"
                     },
                     "response": {
                         "$ref": "CreateShortDynamicLinkResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/firebase"
                     ]
                 }
             }
         }
     },
-    "revision": "20170517",
+    "revision": "20170605",
     "rootUrl": "https://firebasedynamiclinks.googleapis.com/",
     "schemas": {
+        "DynamicLinkEventStat": {
+            "description": "Dynamic Link event stat.",
+            "id": "DynamicLinkEventStat",
+            "properties": {
+                "count": {
+                    "description": "The number of times this event occurred.",
+                    "format": "int64",
+                    "type": "string"
+                },
+                "event": {
+                    "description": "Link event.",
+                    "enum": [
+                        "DYNAMIC_LINK_EVENT_UNSPECIFIED",
+                        "CLICK",
+                        "REDIRECT",
+                        "APP_INSTALL",
+                        "APP_FIRST_OPEN",
+                        "APP_RE_OPEN"
+                    ],
+                    "enumDescriptions": [
+                        "Unspecified type.",
+                        "Indicates that an FDL is clicked by users.",
+                        "Indicates that an FDL redirects users to fallback link.",
+                        "Indicates that an FDL triggers an app install from Play store, currently\nit's impossible to get stats from App store.",
+                        "Indicates that the app is opened for the first time after an install\ntriggered by FDLs",
+                        "Indicates that the app is opened via an FDL for non-first time."
+                    ],
+                    "type": "string"
+                },
+                "platform": {
+                    "description": "Requested platform.",
+                    "enum": [
+                        "DYNAMIC_LINK_PLATFORM_UNSPECIFIED",
+                        "ANDROID",
+                        "IOS",
+                        "DESKTOP"
+                    ],
+                    "enumDescriptions": [
+                        "Unspecified platform.",
+                        "Represents Android platform.\nAll apps and browsers on Android are classfied in this category.",
+                        "Represents iOS platform.\nAll apps and browsers on iOS are classfied in this category.",
+                        "Represents desktop.\nNote: other platforms like Windows, Blackberry, Amazon fall into this\ncategory."
+                    ],
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "CreateShortDynamicLinkResponse": {
             "description": "Response to create a short Dynamic Link.",
             "id": "CreateShortDynamicLinkResponse",
             "properties": {
                 "shortLink": {
                     "description": "Short Dynamic Link value. e.g. https://abcd.app.goo.gl/wxyz",
                     "type": "string"
                 },
                 "previewLink": {
                     "description": "Preivew link to show the link flow chart.",
@@ skipping 58 matching lines @@
                     "description": "Campaign content; used for A/B testing and content-targeted ads to\ndifferentiate ads or links that point to the same URL.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DynamicLinkInfo": {
             "description": "Information about a Dynamic Link.",
             "id": "DynamicLinkInfo",
             "properties": {
-                "dynamicLinkDomain": {
-                    "description": "Dynamic Links domain that the project owns, e.g. abcd.app.goo.gl\n[Learn more](https://firebase.google.com/docs/dynamic-links/android/receive)\non how to set up Dynamic Link domain associated with your Firebase project.\n\nRequired.",
-                    "type": "string"
-                },
-                "link": {
-                    "description": "The link your app will open, You can specify any URL your app can handle.\nThis link must be a well-formatted URL, be properly URL-encoded, and use\nthe HTTP or HTTPS scheme. See 'link' parameters in the\n[documentation](https://firebase.google.com/docs/dynamic-links/create-manually).\n\nRequired.",
-                    "type": "string"
-                },
                 "iosInfo": {
                     "$ref": "IosInfo",
                     "description": "iOS related information. See iOS related parameters in the\n[documentation](https://firebase.google.com/docs/dynamic-links/create-manually)."
                 },
                 "socialMetaTagInfo": {
                     "$ref": "SocialMetaTagInfo",
                     "description": "Parameters for social meta tag params.\nUsed to set meta tag data for link previews on social sites."
                 },
                 "androidInfo": {
                     "$ref": "AndroidInfo",
                     "description": "Android related information. See Android related parameters in the\n[documentation](https://firebase.google.com/docs/dynamic-links/create-manually)."
                 },
                 "navigationInfo": {
                     "$ref": "NavigationInfo",
                     "description": "Information of navigation behavior of a Firebase Dynamic Links."
                 },
                 "analyticsInfo": {
                     "$ref": "AnalyticsInfo",
                     "description": "Parameters used for tracking. See all tracking parameters in the\n[documentation](https://firebase.google.com/docs/dynamic-links/create-manually)."
+                },
+                "dynamicLinkDomain": {
+                    "description": "Dynamic Links domain that the project owns, e.g. abcd.app.goo.gl\n[Learn more](https://firebase.google.com/docs/dynamic-links/android/receive)\non how to set up Dynamic Link domain associated with your Firebase project.\n\nRequired.",
+                    "type": "string"
+                },
+                "link": {
+                    "description": "The link your app will open, You can specify any URL your app can handle.\nThis link must be a well-formatted URL, be properly URL-encoded, and use\nthe HTTP or HTTPS scheme. See 'link' parameters in the\n[documentation](https://firebase.google.com/docs/dynamic-links/create-manually).\n\nRequired.",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "ITunesConnectAnalytics": {
             "description": "Parameters for iTunes Connect App Analytics.",
             "id": "ITunesConnectAnalytics",
             "properties": {
                 "at": {
                     "description": "Affiliate token used to create affiliate-coded links.",
                     "type": "string"
                 },
+                "mt": {
+                    "description": "iTune media types, including music, podcasts, audiobooks and so on.",
+                    "type": "string"
+                },
                 "ct": {
                     "description": "Campaign text that developers can optionally add to any link in order to\ntrack sales from a specific marketing campaign.",
                     "type": "string"
                 },
-                "mt": {
-                    "description": "iTune media types, including music, podcasts, audiobooks and so on.",
-                    "type": "string"
-                },
                 "pt": {
                     "description": "Provider token that enables analytics for Dynamic Links from within iTunes\nConnect.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "SocialMetaTagInfo": {
             "description": "Parameters for social meta tag params.\nUsed to set meta tag data for link previews on social sites.",
             "id": "SocialMetaTagInfo",
             "properties": {
-                "socialDescription": {
-                    "description": "A short description of the link. Optional.",
+                "socialImageLink": {
+                    "description": "An image url string. Optional.",
                     "type": "string"
                 },
                 "socialTitle": {
                     "description": "Title to be displayed. Optional.",
                     "type": "string"
                 },
-                "socialImageLink": {
-                    "description": "An image url string. Optional.",
+                "socialDescription": {
+                    "description": "A short description of the link. Optional.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AndroidInfo": {
             "description": "Android related attributes to the Dynamic Link.",
             "id": "AndroidInfo",
             "properties": {
                 "androidPackageName": {
@@ skipping 85 matching lines @@
                     ],
                     "type": "string"
                 },
                 "warningMessage": {
                     "description": "The warning message to help developers improve their requests.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "DynamicLinkStats": {
+            "description": "Analytics stats of a Dynamic Link for a given timeframe.",
+            "id": "DynamicLinkStats",
+            "properties": {
+                "linkEventStats": {
+                    "description": "Dynamic Link event stats.",
+                    "items": {
+                        "$ref": "DynamicLinkEventStat"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
         "NavigationInfo": {
             "description": "Information of navigation behavior.",
             "id": "NavigationInfo",
             "properties": {
                 "enableForcedRedirect": {
                     "description": "If this option is on, FDL click will be forced to redirect rather than\nshow an interstitial page.",
                     "type": "boolean"
                 }
             },
             "type": "object"
         },
         "IosInfo": {
             "description": "iOS related attributes to the Dynamic Link..",
             "id": "IosInfo",
             "properties": {
+                "iosAppStoreId": {
+                    "description": "iOS App Store ID.",
+                    "type": "string"
+                },
                 "iosIpadFallbackLink": {
                     "description": "If specified, this overrides the ios_fallback_link value on iPads.",
                     "type": "string"
                 },
                 "iosIpadBundleId": {
                     "description": "iPad bundle ID of the app.",
                     "type": "string"
                 },
                 "iosCustomScheme": {
                     "description": "Custom (destination) scheme to use for iOS. By default, we’ll use the\nbundle ID as the custom scheme. Developer can override this behavior using\nthis param.",
                     "type": "string"
                 },
                 "iosBundleId": {
                     "description": "iOS bundle ID of the app.",
                     "type": "string"
                 },
                 "iosFallbackLink": {
                     "description": "Link to open on iOS if the app is not installed.",
                     "type": "string"
-                },
-                "iosAppStoreId": {
-                    "description": "iOS App Store ID.",
-                    "type": "string"
                 }
             },
             "type": "object"
         },
         "AnalyticsInfo": {
             "description": "Tracking parameters supported by Dynamic Link.",
             "id": "AnalyticsInfo",
             "properties": {
                 "itunesConnectAnalytics": {
                     "$ref": "ITunesConnectAnalytics",
                     "description": "iTunes Connect App Analytics."
                 },
                 "googlePlayAnalytics": {
                     "$ref": "GooglePlayAnalytics",
                     "description": "Google Play Campaign Measurements."
                 }
             },
             "type": "object"
         },
         "CreateShortDynamicLinkRequest": {
             "description": "Request to create a short Dynamic Link.",
             "id": "CreateShortDynamicLinkRequest",
             "properties": {
-                "longDynamicLink": {
-                    "description": "Full long Dynamic Link URL with desired query parameters specified.\nFor example,\n\"https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample\",\n[Learn more](https://firebase.google.com/docs/dynamic-links/android#create-a-dynamic-link-programmatically).",
-                    "type": "string"
-                },
                 "suffix": {
                     "$ref": "Suffix",
                     "description": "Short Dynamic Link suffix. Optional."
                 },
                 "dynamicLinkInfo": {
                     "$ref": "DynamicLinkInfo",
                     "description": "Information about the Dynamic Link to be shortened.\n[Learn more](https://firebase.google.com/docs/dynamic-links/android#create-a-dynamic-link-programmatically)."
+                },
+                "longDynamicLink": {
+                    "description": "Full long Dynamic Link URL with desired query parameters specified.\nFor example,\n\"https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample\",\n[Learn more](https://firebase.google.com/docs/dynamic-links/android#create-a-dynamic-link-programmatically).",
+                    "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Firebase Dynamic Links API",
     "version": "v1"
 }