Share via


Open_graph_objects - Get

Definition

https://www.yammer.com/api/v1/open_graph_objects

Parameters

Name In Required Type Description
url query string URL identifying the Open Graph Object.

Documentation

Retrieve Open Graph Object (link) metadata for a specific URL by making a request to /api/v1/open_graph_objects with the URL specified as a query parameter.

Example: https://www.yammer.com/api/v1/open_graph_objects?url=https://portal.office.com
  1. Multiple Open Graph Objects might exist in each Yammer Network for an absolute URL (web link).
  2. These links as well as the messages associated with them are only public to users who have access to the conversations the Open Graph Objects were a part of.
  3. If one or multiple Open Graph Objects exist, the API will return the metadata, including the unique identifier for use with the Open Graph messages endpoint, of one of the Open Graph Objects (selected randomly). The response will include an additional field "ogos" that will contain the list of all Open Graph Objects associated with a link.

Here is an example of what the response of the API will look like:

{

"id": 12345,

...,

"ogos": [{

"id": 12345,

....

}, {

"id": 67890,

....

}]

}"

If no Open Graph Object exists, then a 404 Not Found response will be returned.