OLD | NEW |
(Empty) | |
| 1 { |
| 2 "auth": { |
| 3 "oauth2": { |
| 4 "scopes": { |
| 5 "https://www.googleapis.com/auth/urlshortener": { |
| 6 "description": "Manage your goo.gl short URLs" |
| 7 } |
| 8 } |
| 9 } |
| 10 }, |
| 11 "basePath": "/urlshortener/v1/", |
| 12 "baseUrl": "https://www.googleapis.com/urlshortener/v1/", |
| 13 "batchPath": "batch", |
| 14 "description": "Lets you create, inspect, and manage goo.gl short URLs", |
| 15 "discoveryVersion": "v1", |
| 16 "documentationLink": "http://code.google.com/apis/urlshortener/v1/getting_st
arted.html", |
| 17 "etag": "\"uUWyYHXmEn-ab7WLvo8qNz2S8ws/T4bB77XUfbpGWn7xKXxC7yFKgeE\"", |
| 18 "icons": { |
| 19 "x16": "http://www.google.com/images/icons/product/search-16.gif", |
| 20 "x32": "http://www.google.com/images/icons/product/search-32.gif" |
| 21 }, |
| 22 "id": "urlshortener:v1", |
| 23 "kind": "discovery#restDescription", |
| 24 "name": "urlshortener", |
| 25 "ownerDomain": "google.com", |
| 26 "ownerName": "Google", |
| 27 "parameters": { |
| 28 "alt": { |
| 29 "default": "json", |
| 30 "description": "Data format for the response.", |
| 31 "enum": [ |
| 32 "json" |
| 33 ], |
| 34 "enumDescriptions": [ |
| 35 "Responses with Content-Type of application/json" |
| 36 ], |
| 37 "location": "query", |
| 38 "type": "string" |
| 39 }, |
| 40 "fields": { |
| 41 "description": "Selector specifying which fields to include in a par
tial response.", |
| 42 "location": "query", |
| 43 "type": "string" |
| 44 }, |
| 45 "key": { |
| 46 "description": "API key. Your API key identifies your project and pr
ovides you with API access, quota, and reports. Required unless you provide an O
Auth 2.0 token.", |
| 47 "location": "query", |
| 48 "type": "string" |
| 49 }, |
| 50 "oauth_token": { |
| 51 "description": "OAuth 2.0 token for the current user.", |
| 52 "location": "query", |
| 53 "type": "string" |
| 54 }, |
| 55 "prettyPrint": { |
| 56 "default": "true", |
| 57 "description": "Returns response with indentations and line breaks."
, |
| 58 "location": "query", |
| 59 "type": "boolean" |
| 60 }, |
| 61 "quotaUser": { |
| 62 "description": "Available to use for quota purposes for server-side
applications. Can be any arbitrary string assigned to a user, but should not exc
eed 40 characters. Overrides userIp if both are provided.", |
| 63 "location": "query", |
| 64 "type": "string" |
| 65 }, |
| 66 "userIp": { |
| 67 "description": "IP address of the site where the request originates.
Use this if you want to enforce per-user limits.", |
| 68 "location": "query", |
| 69 "type": "string" |
| 70 } |
| 71 }, |
| 72 "protocol": "rest", |
| 73 "resources": { |
| 74 "url": { |
| 75 "methods": { |
| 76 "get": { |
| 77 "description": "Expands a short URL or gets creation time an
d analytics.", |
| 78 "httpMethod": "GET", |
| 79 "id": "urlshortener.url.get", |
| 80 "parameterOrder": [ |
| 81 "shortUrl" |
| 82 ], |
| 83 "parameters": { |
| 84 "projection": { |
| 85 "description": "Additional information to return.", |
| 86 "enum": [ |
| 87 "ANALYTICS_CLICKS", |
| 88 "ANALYTICS_TOP_STRINGS", |
| 89 "FULL" |
| 90 ], |
| 91 "enumDescriptions": [ |
| 92 "Returns only click counts.", |
| 93 "Returns only top string counts.", |
| 94 "Returns the creation timestamp and all availabl
e analytics." |
| 95 ], |
| 96 "location": "query", |
| 97 "type": "string" |
| 98 }, |
| 99 "shortUrl": { |
| 100 "description": "The short URL, including the protoco
l.", |
| 101 "location": "query", |
| 102 "required": true, |
| 103 "type": "string" |
| 104 } |
| 105 }, |
| 106 "path": "url", |
| 107 "response": { |
| 108 "$ref": "Url" |
| 109 } |
| 110 }, |
| 111 "insert": { |
| 112 "description": "Creates a new short URL.", |
| 113 "httpMethod": "POST", |
| 114 "id": "urlshortener.url.insert", |
| 115 "path": "url", |
| 116 "request": { |
| 117 "$ref": "Url" |
| 118 }, |
| 119 "response": { |
| 120 "$ref": "Url" |
| 121 }, |
| 122 "scopes": [ |
| 123 "https://www.googleapis.com/auth/urlshortener" |
| 124 ] |
| 125 }, |
| 126 "list": { |
| 127 "description": "Retrieves a list of URLs shortened by a user
.", |
| 128 "httpMethod": "GET", |
| 129 "id": "urlshortener.url.list", |
| 130 "parameters": { |
| 131 "projection": { |
| 132 "description": "Additional information to return.", |
| 133 "enum": [ |
| 134 "ANALYTICS_CLICKS", |
| 135 "FULL" |
| 136 ], |
| 137 "enumDescriptions": [ |
| 138 "Returns short URL click counts.", |
| 139 "Returns short URL click counts." |
| 140 ], |
| 141 "location": "query", |
| 142 "type": "string" |
| 143 }, |
| 144 "start-token": { |
| 145 "description": "Token for requesting successive page
s of results.", |
| 146 "location": "query", |
| 147 "type": "string" |
| 148 } |
| 149 }, |
| 150 "path": "url/history", |
| 151 "response": { |
| 152 "$ref": "UrlHistory" |
| 153 }, |
| 154 "scopes": [ |
| 155 "https://www.googleapis.com/auth/urlshortener" |
| 156 ] |
| 157 } |
| 158 } |
| 159 } |
| 160 }, |
| 161 "rootUrl": "https://www.googleapis.com/", |
| 162 "schemas": { |
| 163 "AnalyticsSnapshot": { |
| 164 "id": "AnalyticsSnapshot", |
| 165 "properties": { |
| 166 "browsers": { |
| 167 "description": "Top browsers, e.g. \"Chrome\"; sorted by (de
scending) click counts. Only present if this data is available.", |
| 168 "items": { |
| 169 "$ref": "StringCount" |
| 170 }, |
| 171 "type": "array" |
| 172 }, |
| 173 "countries": { |
| 174 "description": "Top countries (expressed as country codes),
e.g. \"US\" or \"DE\"; sorted by (descending) click counts. Only present if this
data is available.", |
| 175 "items": { |
| 176 "$ref": "StringCount" |
| 177 }, |
| 178 "type": "array" |
| 179 }, |
| 180 "longUrlClicks": { |
| 181 "description": "Number of clicks on all goo.gl short URLs po
inting to this long URL.", |
| 182 "format": "int64", |
| 183 "type": "string" |
| 184 }, |
| 185 "platforms": { |
| 186 "description": "Top platforms or OSes, e.g. \"Windows\"; sor
ted by (descending) click counts. Only present if this data is available.", |
| 187 "items": { |
| 188 "$ref": "StringCount" |
| 189 }, |
| 190 "type": "array" |
| 191 }, |
| 192 "referrers": { |
| 193 "description": "Top referring hosts, e.g. \"www.google.com\"
; sorted by (descending) click counts. Only present if this data is available.", |
| 194 "items": { |
| 195 "$ref": "StringCount" |
| 196 }, |
| 197 "type": "array" |
| 198 }, |
| 199 "shortUrlClicks": { |
| 200 "description": "Number of clicks on this short URL.", |
| 201 "format": "int64", |
| 202 "type": "string" |
| 203 } |
| 204 }, |
| 205 "type": "object" |
| 206 }, |
| 207 "AnalyticsSummary": { |
| 208 "id": "AnalyticsSummary", |
| 209 "properties": { |
| 210 "allTime": { |
| 211 "$ref": "AnalyticsSnapshot", |
| 212 "description": "Click analytics over all time." |
| 213 }, |
| 214 "day": { |
| 215 "$ref": "AnalyticsSnapshot", |
| 216 "description": "Click analytics over the last day." |
| 217 }, |
| 218 "month": { |
| 219 "$ref": "AnalyticsSnapshot", |
| 220 "description": "Click analytics over the last month." |
| 221 }, |
| 222 "twoHours": { |
| 223 "$ref": "AnalyticsSnapshot", |
| 224 "description": "Click analytics over the last two hours." |
| 225 }, |
| 226 "week": { |
| 227 "$ref": "AnalyticsSnapshot", |
| 228 "description": "Click analytics over the last week." |
| 229 } |
| 230 }, |
| 231 "type": "object" |
| 232 }, |
| 233 "StringCount": { |
| 234 "id": "StringCount", |
| 235 "properties": { |
| 236 "count": { |
| 237 "description": "Number of clicks for this top entry, e.g. fo
r this particular country or browser.", |
| 238 "format": "int64", |
| 239 "type": "string" |
| 240 }, |
| 241 "id": { |
| 242 "description": "Label assigned to this top entry, e.g. \"US\
" or \"Chrome\".", |
| 243 "type": "string" |
| 244 } |
| 245 }, |
| 246 "type": "object" |
| 247 }, |
| 248 "Url": { |
| 249 "id": "Url", |
| 250 "properties": { |
| 251 "analytics": { |
| 252 "$ref": "AnalyticsSummary", |
| 253 "description": "A summary of the click analytics for the sho
rt and long URL. Might not be present if not requested or currently unavailable.
" |
| 254 }, |
| 255 "created": { |
| 256 "description": "Time the short URL was created; ISO 8601 rep
resentation using the yyyy-MM-dd'T'HH:mm:ss.SSSZZ format, e.g. \"2010-10-14T19:0
1:24.944+00:00\".", |
| 257 "type": "string" |
| 258 }, |
| 259 "id": { |
| 260 "description": "Short URL, e.g. \"http://goo.gl/l6MS\".", |
| 261 "type": "string" |
| 262 }, |
| 263 "kind": { |
| 264 "default": "urlshortener#url", |
| 265 "description": "The fixed string \"urlshortener#url\".", |
| 266 "type": "string" |
| 267 }, |
| 268 "longUrl": { |
| 269 "description": "Long URL, e.g. \"http://www.google.com/\". M
ight not be present if the status is \"REMOVED\".", |
| 270 "type": "string" |
| 271 }, |
| 272 "status": { |
| 273 "description": "Status of the target URL. Possible values: \
"OK\", \"MALWARE\", \"PHISHING\", or \"REMOVED\". A URL might be marked \"REMOVE
D\" if it was flagged as spam, for example.", |
| 274 "type": "string" |
| 275 } |
| 276 }, |
| 277 "type": "object" |
| 278 }, |
| 279 "UrlHistory": { |
| 280 "id": "UrlHistory", |
| 281 "properties": { |
| 282 "items": { |
| 283 "description": "A list of URL resources.", |
| 284 "items": { |
| 285 "$ref": "Url" |
| 286 }, |
| 287 "type": "array" |
| 288 }, |
| 289 "itemsPerPage": { |
| 290 "description": "Number of items returned with each full \"pa
ge\" of results. Note that the last page could have fewer items than the \"items
PerPage\" value.", |
| 291 "format": "int32", |
| 292 "type": "integer" |
| 293 }, |
| 294 "kind": { |
| 295 "default": "urlshortener#urlHistory", |
| 296 "description": "The fixed string \"urlshortener#urlHistory\"
.", |
| 297 "type": "string" |
| 298 }, |
| 299 "nextPageToken": { |
| 300 "description": "A token to provide to get the next page of r
esults.", |
| 301 "type": "string" |
| 302 }, |
| 303 "totalItems": { |
| 304 "description": "Total number of short URLs associated with t
his user (may be approximate).", |
| 305 "format": "int32", |
| 306 "type": "integer" |
| 307 } |
| 308 }, |
| 309 "type": "object" |
| 310 } |
| 311 }, |
| 312 "servicePath": "urlshortener/v1/", |
| 313 "title": "URL Shortener API", |
| 314 "version": "v1" |
| 315 } |
OLD | NEW |