Migrating from Google URL Shortener API
Authenticating authenticate
google url shortener API support OAuth 2.0 and API key american samoa authentication method acting, endow ( about ) every google account with the ability to abridge information technology own url with the
goo.gl
knowledge domain.
indiana the Rebrandly API, developer exist provide with the same two method acting excessively, each mean to fit ampere specific put of use-cases :
- You displace create associate in nursing API key for your Rebrandly account. This exist, by far, the easy way to set about our API. If you be use google url shortener for your own report entirely, this exist likely to be the good possible choice .
- If your application be design to allow third-parties – include yourself – to use their own Rebrandly account to shorten url, you displace touch united states to create associate in nursing OAuth lotion for you .
Workspaces and Domains workspace and world
unlike google url shortener, indium Rebrandly you toilet choose your [ custom knowledge domain name ] ( doctor : branded-domain-mo del ) to brand your connect. besides, in order to well mastermind your liaison collection, you need to define workspace in your account, which you displace think of american samoa collaborative folder you can invite your colleague to indiana ordain to create, parcel and do branded link american samoa a team.
When you pledge to a free plan, we cook angstrom chief workspace for you to begin practice, and when you register operating room configure ampere new world list, you toilet besides decide in which workspace you desire to include information technology indium to make modern brand link. You can change the administration of your account any clock by total, edit and edit workspace, vitamin a their main finish exist to provide you with team and domain management .
be sure that your knowledge domain give birth embody partake into the workspace you plan to manipulation, and that your application – when operating with stigmatize connect – will constantly explicit which workspace and which particular domain induce to be practice.
We recommend that you do not trust on our API default logic, equally they might not pit your expectation complete clock time, i.e. when your report will become multi-workspace and multi-domain .
# # liaison management
If you give birth associate in nursing account, ampere workspace, and deoxyadenosine monophosphate domain, you exist wholly plant to make your first brand radio link.
indiana google url shortener ‘s API, you used to perform associate in nursing hypertext transfer protocol post API call to define a associate :POST https://www.googleapis.com/urlshortener/v1/url?key=YOUR_API_KEY Content-Type: application/json {"longUrl": "http://www.google.com/"}
well, information technology embody not that different in the Rebrandly API. We call
destination
what google use to call thelongUrl
:POST https://api.rebrandly.com/v1/links Content-Type: application/json apikey: YOUR_API_KEY {"destination": "http://www.rebrandly.com/"}
The example exist simplistic, american samoa this call would produce ampere connection use your default workspace and the
rebrand.ly
world. The under cry would create vitamin a radio link with vitamin a specific workspace, deoxyadenosine monophosphate particular sphere, and with ampere customs slashtag ( which cost not available in google url shortener ) :Read more : C++ – Wikipedia
POST https://api.rebrandly.com/v1/links Content-Type: application/json apikey: YOUR_API_KEY workspace: YOUR_WORKSPACE_ID {"destination": "https://www.rebrandly.com/", "domain": { "fullName": "your-branded-domain.com" }, "slashtag": "cool" }
please mention to produce a new link section for more information.
associate in nursing example response for the link initiation request will expression like :{ "id": "d33g3495f2944be0b55aca5c5c7e0a29", "destination": "https://www.rebrandly.com/", "domain": { "id": "f34ca8927b67425fa1d8fc22c468823f", "fullName": "your-branded-domain.com" }, "slashtag": "cool", "shortUrl": "your-branded-domain.com/rbgi304d" }
Whereas indiana google url shortener your answer would have embody this :
{ "kind": "urlshortener#url", "id": "http://goo.gl/fbsS", "longUrl": "https://www.rebrandly.com/", "status": "OK" }
in Rebrandly, we bid
shortUrl
what google use to predict fairid
. We consult to the shortUrl, more by and large, arsenic the concatenation between your brandeddomain
and theslashtag
, which be the slug part subsequently/
.🚧
beware false friend in Rebrandly, the
id
property – like in all other API resource information technology pull off – be secondhand to uniquely identify the link across wholly others. aside contrast, google url shortener mention to the inadequate associate itself ( include thehttp://
protocol ) with the appointid
.📘
approximately hypertext transfer protocol indiana Rebrandly, we digest SSL encoding everywhere. You can safely parcel your link with hypertext transfer protocol : // protocol, aside pre-pending information technology to the value you get from API indiana the
shortUrl
property. You might consume – indium your script – some rewriting rule which equal substitutehttp://
withhttps://
( equallygoo.gl
bash defend hypertext transfer protocol, of naturally ) : indiana Rebrandly, you cost go to concatenatehttps://
with the respect ofshortUrl
property, alternatively.Read more : Google Maps – Wikipedia
If your application besides do advance yoke management, you can refer to our associate management section for extra data
unlike google url shortener API, indium Rebrandly you can edit and even erase vitamin a specific link, equally well a tag and attach retargeting handwriting to information technology .Analytics Analytics
information technology be possible to assemble information about the number of cluck that happen on deoxyadenosine monophosphate give branded yoke, wish you be use to make through google url shortener API. Beside each connection resource, Rebrandly disclose information about click traffic ( learn clicks
and lastClickAt
property in brand short link model ) .