Loadingcs293

Sharing Notes

Private and public note sharing

A user can share his or her Evernote notes and notebooks with a specific user, a certain group of users or the world.

1. When you share a Note with an Evernote user, use the “Share Note” option that will open a new Work chat and attach your Note to the chat. You’ll need to enter the other person’s name or e-mail address. If you’ve chatted with that person before, Evernote will prompt you with matching names. You can also add a message along with your Note.
2. Discounts average $34 off with a Evernote promo code or coupon. 6 Evernote coupons now on RetailMeNot.

This diagram shows the different sharing options in Evernote:

Sharing options

[1] Generate unique URL giving access to everybody who knows the URL

Share a note within Evernote Mac The new Evernote for Mac Open the note you would like to share. Click the green Share button. Enter at least one. Windows The new Evernote for Windows Open the note you would like to share. Click the green Share button. IPhone, iPad, and iPod. Share in Internet Explorer and Firefox Save your Web Clip from any browser, then share it from your Evernote account. After you save your clip, open your Evernote account (log in if prompted). Open the note (s) you've clipped and select the note sharing button in the toolbar near the top of your note.

[2] Grant access to a specific notebook to specific Evernote users

[3] Make a notebook public and share it with the world

Sharing a single note

Sharing a single note by URL

You can also share a single note by generating a URL that will allow anybody who knows the URL to view the note in a browser. The URL always shares the current content of the note, so if the note is changed after it is shared, the recipients will see the changes.

Important Marvelous designer for mac.

An application may only turn on sharing for a note when the user explicitly chooses to do so - for example by tapping a 'share' button. You may never enable sharing without the user's explicit consent.

To enable sharing by URL for a note, you must first turn on sharing using shareNote. This will generate a share key, which you can then use to assemble the URL:

https://host.evernote.com/shard/shardId/sh/noteGuid/noteKey

For example:

In the URL above, the shardId is s1, the note's GUID is 3554a82b-54d3-4673-8641-2bbcac94bbff, and the share key is d368012bd2c3ce342c709fefd26355a7.

Sharing can be turned off for a given note using stopSharingNote. Once stopSharingNote has been called, previously shared URLs will stop working. If sharing is later re-enabled, a new share key will be generated and a new URL will need to be assembled.

An application can also read a shared single note if it has the components used to assemble the sharing URL. Here's how your can read the note that I shared above:

Sharing entire notebooks

Users can also share entire notebooks, either with specific recipients or publicly. Notebooks that are shared with specific recipients can optionally require the recipient to log into Evernote to view the shared notebook. Premium users can also allow recipients to modify the notes within a shared notebook. Because of the number of possible configurations, sharing notebooks is relatively complex.

There are two data model objects involved in sharing notebooks - SharedNotebook and LinkedNotebook. The SharedNotebook object lives in the notebook owner's account - think of it as an invitation to view a specific notebook. The LinkedNotebook object lives in the share recipient's account and represents a persistent link to the notebook in the owner's account. Because users can view shared notebooks without logging into Evernote (if the notebook owner allows them to), there doesn't need to be a LinkedNotebook for every SharedNotebook.

Sharing a notebook

To share a notebook, you create a SharedNotebook object in the notebook owner's account. A SharedNotebook shares the notebook with a single email address, so to share a notebook with three friends, you will create three SharedNotebook objects.

Creating a SharedNotebook doesn't automatically generate an invitation to the recipient. If your application turns on sharing for a notebook by creating a SharedNotebook, you will need to ensure that the recipient receives the information that they need to access the share. Similarly, LinkedNotebooks are not created automatically. The Evernote service can create a LinkedNotebook when a user views a shared notebook invitation in their browser, or your application can programmatically accept the share and create the LinkedNotebook in the recipient's account.

Reading notes from linked notebooks

When your application accesses a user's Evernote account through the Cloud API, you can get a list of LinkedNotebooks - notebooks owned by another user that have been shared with your user. Once you have that list, you can acess the notes in the owner's notebook. To do this, you need to create a second NoteStore connection, since the owner's account and the recipient's account may be on different shards. Using that NoteStore connection, you can obtain a second authentication token that will allow you to access the contents of the shared notebook.

Once you have an authentication token to read from the shared notebook, you can use any of the NoteStore functions to interact with the notes in that notebook. The sample code above uses findNotes to get all of the notes in the shared notebook. Note that you need to you must set the NoteFilter.notebookGuid to the appropriate notebook GUID when using findNotes and findNotesMetadata on a shared notebook.

Synchronizing linked notebooks

For a complete guide on synchronizing linked notebooks, download the synchronizing guide.

Note Links

Link directly to individual notes from anywhere

• Note Links
• In-App Note Links
• Public Links

Note Links are used to reference a note in a web browser that when the recipient of the link already has access via notebook or individual note sharing. In-App Note Links also known as ‘Classic Note Links’ are used to reference a note in Evernote clients like when notes are linked to from within other notes and to open notes in a Evernote client in situations were it is known that the user already has access to the note. Public Links are used to share a note with users who do not already have access though a web browser. Public links give access to view the note regardless of the share settings. The user can then save that note to their Evernote account. Public Links can be disabled by the user on a individual basis.

Before we dive into the structure of a link we should first take a look at the components of the links:

• userID- the ID of the user, it should be stated that unless otherwise noted the user ID referenced below is that of the of the owner of that note. If you are only handling a single user's notes, this is simply the user id. The userId can be obtained by calling the getUser method on the userStore object and inspecting the id attribute of the resulting user object.

• shardId - the ID of the shard the note is on. If you're dealing with a single user and their notes, this is the user's shard ID, eg 's29' or 's350”. The shardId can be obtained by calling the getUser method on the userStore object and inspecting the shardId attribute of the resulting user object. Please note that the shard ID will be different for business notes, notes that have been shared to the user, and notes from a notebook that has been shared with the user.

• noteGuid - the GUID of the note being linked to. This can been obtained by inspecting the guid attribute of the note object you wish to share (note: you must call the createNote method on the note object before the guid attribute will be available).

Note Links

Note Links are used to reference a note in a browser when the recipient of the link already has access via notebook or individual note sharing.

Structure

https://[service]/shard/[shardId]/nl/[userId]/[noteGuid]/

Where:

• [service] is the name of the Evernote service (either sandbox.evernote.com or www.evernote.com)
• [userId] is the user ID of the notebook owner
• [shardId] is the shard ID where the note is stored
• [noteGuid] is the GUID of the note that is being linked to

Example:

Access is only granted if the recipient of the note link already has access to the note or to the notebook from which it is being shared. If the user is already logged into a Evernote account that has access to the note the note will open in the browser. If the user is not logged in they will be prompted to login to view the note:

Once the recipient has logged in the note will be opened in the browser (the note may also open in their Evernote client if they have enabled this feature the first time the recipient viewed a shared note via a Share Link).

If the recipient does not have access to the note the recipient is presented with the option to request permission to view the note:

This is useful when you know the recipient already has access to the note and do not wish to share the note publicly. Note links can be generated by the user by right clicking on a note and selecting “Copy Note Link”.

In-App Note Links

In-app links are used within the Evernote application to link to a note from within another notes. In-app Links can also induce the launching and subsequent opening of the desired note in an Evernote client from other applications. All note links start with “evernote:///“ Classic note links allow applications to reference a specific note within an Evernote client application. They can be used to link from one note to another or to allow easy access to a note from another context, such as a calendar invitation. Note links can reference a note, both synchronized and local, within a user's account as well as a note in a shared notebook that the user has read access to. It is important to note that classic note links will only work on a computer or device that has an up-to-date Evernote client application installed.

Structure

evernote:///view/[userId]/[shardId]/[noteGuid]/[noteGuid]/

Where:

• [userId] is the user id of the notebook owner
• [shardId] is the shard id of the notebook owner
• [noteGuid] is the guid of the note that is being linked to

Please note that the note GUID is listed at the end of the link twice, sequentially.

Examples:

or when embedded in HMTL or ENML:

If this link is opened in a browser it will open the Evernote application and if the note is present in the users account it will open that specific note. If the user does not have access to the note an error message from the Evernote application will appear informing the user that the note could not be found.

On Evernote Desktop clients (OS X and Windows) these links are generated when a note link is copied and pasted into another note and when a user right clicks on a note and holds down the alt or option key and selects “Copy Classic Note Link”.

Public Links are used to share a note with users who do not already have access to the note and is intended to open in a browser.

Structure:

https://[service]/shard/[shard ID]/sh/[noteGuid]/[shareKey]/

Where:

• [service] is the name of the Evernote service (either sandbox.evernote.com or www.evernote.com)
• [shardId] is the shard ID where the note is stored
• [noteGuid] is the GUID of the note that is being linked to
• [shareKey] is the share key of the note. The shareKey is generated by calling the shareNote method on the noteStore object with the parameters authenticationToken and the guid of the note to be shared.

Examples:

This is useful when publish notes to external site outside your workspace like social media or a blog. Public links can be generated by the user by clicking on the button next to the “Share” button and selecting “Copy Public Link” in Evernote's desktop clients.

Evernote Sharing

Evernote Shortened URLs

You may notice when copying links from within Evernote clients that the URLs do not take the form of any of those described above. Evernote has a URL shortening service built in to reduce the complexity and length of Evernote share URLs to allow for easier sharing. These shortened URLs automatically redirect to the note links described above. Currently there is no public API for the Evernote share URLs shortening service. Shortened URL take the form:

https://[service]/l/[random string]

Evernote Sharing Not Working

Example: