Google+ Platform

Moments

Moments describe activities that users engage within your app. The app activities comprise an moment type, a target, and many optional fields. The fields that are required when inserting moments depend on the type of moment. Your app can also list moments and delete moments that it previous wrote for the authenticated user.

For a list of methods for this resource, see the end of this page.

Resource representations

{
  "kind": "plus#moment",
  "type": string,
  "target": {
    "kind": "plus#itemScope",
    "type": string,
    "id": string,
    "description": string,
    "image": string,
    "name": string,
    "url": string,
    "author": [
      (ItemScope)
    ],
    "contributor": [
      (ItemScope)
    ],
    "dateCreated": string,
    "dateModified": string,
    "datePublished": string,
    "associated_media": [
      (ItemScope)
    ],
    "thumbnailUrl": string,
    "about": (ItemScope),
    "contentSize": string,
    "contentUrl": string,
    "duration": string,
    "embedUrl": string,
    "height": string,
    "playerType": string,
    "width": string,
    "thumbnail": (ItemScope),
    "caption": string,
    "startDate": string,
    "endDate": string,
    "attendees": [
      (ItemScope)
    ],
    "attendeeCount": integer,
    "location": (ItemScope),
    "performers": [
      (ItemScope)
    ],
    "tickerSymbol": string,
    "additionalName": [
      string
    ],
    "birthDate": string,
    "familyName": string,
    "gender": string,
    "givenName": string,
    "text": string,
    "reviewRating": (ItemScope),
    "ratingValue": string,
    "bestRating": string,
    "worstRating": string,
    "address": (ItemScope),
    "addressCountry": string,
    "addressLocality": string,
    "addressRegion": string,
    "postOfficeBoxNumber": string,
    "postalCode": string,
    "streetAddress": string,
    "geo": (ItemScope),
    "latitude": double,
    "longitude": double,
    "inAlbum": (ItemScope),
    "audio": (ItemScope),
    "byArtist": (ItemScope),
    "partOfTVSeries": (ItemScope)
  },
  "result": {
    "kind": "plus#itemScope",
    "type": string,
    "id": string,
    "description": string,
    "image": string,
    "name": string,
    "url": string,
    "author": [
      (ItemScope)
    ],
    "contributor": [
      (ItemScope)
    ],
    "dateCreated": string,
    "dateModified": string,
    "datePublished": string,
    "associated_media": [
      (ItemScope)
    ],
    "thumbnailUrl": string,
    "about": (ItemScope),
    "contentSize": string,
    "contentUrl": string,
    "duration": string,
    "embedUrl": string,
    "height": string,
    "playerType": string,
    "width": string,
    "thumbnail": (ItemScope),
    "caption": string,
    "startDate": string,
    "endDate": string,
    "attendees": [
      (ItemScope)
    ],
    "attendeeCount": integer,
    "location": (ItemScope),
    "performers": [
      (ItemScope)
    ],
    "tickerSymbol": string,
    "additionalName": [
      string
    ],
    "birthDate": string,
    "familyName": string,
    "gender": string,
    "givenName": string,
    "text": string,
    "reviewRating": (ItemScope),
    "ratingValue": string,
    "bestRating": string,
    "worstRating": string,
    "address": (ItemScope),
    "addressCountry": string,
    "addressLocality": string,
    "addressRegion": string,
    "postOfficeBoxNumber": string,
    "postalCode": string,
    "streetAddress": string,
    "geo": (ItemScope),
    "latitude": double,
    "longitude": double,
    "inAlbum": (ItemScope),
    "audio": (ItemScope),
    "byArtist": (ItemScope),
    "partOfTVSeries": (ItemScope)
  },
  "startDate": datetime,
  "id": string
}
Property name Value Description Notes
kind string Identifies this resource as a moment.
type string The Google schema for the type of moment to write. For example, http://schemas.google.com/AddActivity. writable
target nested object The object on which the action was performed.
target.kind string Identifies this resource as an itemScope.
target.type string The schema.org URL that best describes the referenced target and matches the type of moment.
target.id string An identifier for the target. Your app can choose how to identify targets. The target.id is required if you are writing an activity that does not have a corresponding web page or target.url property.
target.description string The string that describes the content of the result.
target.image string A URL to the image that represents this result. For example, if a user writes a review of a restaurant and attaches a photo of their meal, you might use that photo as the result.image.
target.name string The name of the result. In the example of a restaurant review, this might be the summary the user gave their review such as "Great ambiance, but overpriced."
target.url string The URL that points to the result object. For example, a permalink directly to a restaurant reviewer's comment.
target.author[] list The person or persons who created this result. In the example of restaurant reviews, this might be the reviewer's name.
target.contributor[] list A list of contributors to this result.
target.dateCreated string The date the result was created such as the date that a review was first created.
target.dateModified string The date the result was last modified such as the date that a review was last edited.
target.datePublished string The initial date that the result was published. For example, a user writes a comment on a blog, which has a result.dateCreated of when they submit it. If the blog users comment moderation, the result.datePublished value would match the date when the owner approved the message.
target.associated_media[] list The encoding.
target.thumbnailUrl string A URL to a thumbnail image that represents this result.
target.about nested object The subject matter of the content.
target.contentSize string File size in (mega/kilo) bytes.
target.contentUrl string Actual bytes of the media object, for example the image file or video file.
target.duration string The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format.
target.embedUrl string A URL pointing to a player for a specific video. In general, this is the information in the src element of an embed tag and should not be the same as the content of the loc tag.
target.height string The height of the media object.
target.playerType string Player type that is required. For example: Flash or Silverlight.
target.width string The width of the media object.
target.thumbnail nested object Thumbnail image for an image or video.
target.caption string The caption for this object.
target.startDate string The start date and time of the event (in ISO 8601 date format).
target.endDate string The end date and time of the event (in ISO 8601 date format).
target.attendees[] list A person attending the event.
target.attendeeCount integer Number of attendees.
target.location nested object The location of the event or organization.
target.performers[] list The main performer or performers of the event-for example, a presenter, musician, or actor.
target.tickerSymbol string The exchange traded instrument associated with a Corporation object. The tickerSymbol is expressed as an exchange and an instrument name separated by a space character. For the exchange component of the tickerSymbol attribute, we reccommend using the controlled vocaulary of Market Identifier Codes (MIC) specified in ISO15022.
target.additionalName[] list An additional name for a Person, can be used for a middle name.
target.birthDate string Date of birth.
target.familyName string Family name. This property can be used with givenName instead of the name property.
target.gender string Gender of the person.
target.givenName string Given name. This property can be used with familyName instead of the name property.
target.text string The text that is the result of the app activity. For example, if a user leaves a review of a restaurant, this might be the text of the review.
target.reviewRating nested object Review rating.
target.ratingValue string Rating value.
target.bestRating string Best possible rating value that a result might obtain. This property defines the upper bound for the ratingValue. For example, you might have a 5 star rating scale, you would provide 5 as the value for this property.
target.worstRating string Worst possible rating value that a result might obtain. This property defines the lower bound for the ratingValue.
target.address nested object Postal address.
target.addressCountry string Address country.
target.addressLocality string Address locality.
target.addressRegion string Address region.
target.postOfficeBoxNumber string Post office box number.
target.postalCode string Postal code.
target.streetAddress string Street address.
target.geo nested object Geo coordinates.
target.latitude double Latitude.
target.longitude double Longitude.
target.inAlbum nested object From http://schema.org/MusicRecording, which album a song is in.
target.audio nested object From http://schema.org/MusicRecording, the audio file.
target.byArtist nested object From http://schema.org/MusicRecording, the artist that performed this recording.
target.partOfTVSeries nested object Property of http://schema.org/TVEpisode indicating which series the episode belongs to.
result nested object The object generated by performing the action on the target. For example, a user writes a review of a restaurant, the target is the restaurant and the result is the review.
result.kind string Identifies this resource as an itemScope.
result.type string The schema.org URL that best describes the referenced target and matches the type of moment.
result.id string An identifier for the target. Your app can choose how to identify targets. The target.id is required if you are writing an activity that does not have a corresponding web page or target.url property.
result.description string The string that describes the content of the result.
result.image string A URL to the image that represents this result. For example, if a user writes a review of a restaurant and attaches a photo of their meal, you might use that photo as the result.image.
result.name string The name of the result. In the example of a restaurant review, this might be the summary the user gave their review such as "Great ambiance, but overpriced."
result.url string The URL that points to the result object. For example, a permalink directly to a restaurant reviewer's comment.
result.author[] list The person or persons who created this result. In the example of restaurant reviews, this might be the reviewer's name.
result.contributor[] list A list of contributors to this result.
result.dateCreated string The date the result was created such as the date that a review was first created.
result.dateModified string The date the result was last modified such as the date that a review was last edited.
result.datePublished string The initial date that the result was published. For example, a user writes a comment on a blog, which has a result.dateCreated of when they submit it. If the blog users comment moderation, the result.datePublished value would match the date when the owner approved the message.
result.associated_media[] list The encoding.
result.thumbnailUrl string A URL to a thumbnail image that represents this result.
result.about nested object The subject matter of the content.
result.contentSize string File size in (mega/kilo) bytes.
result.contentUrl string Actual bytes of the media object, for example the image file or video file.
result.duration string The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format.
result.embedUrl string A URL pointing to a player for a specific video. In general, this is the information in the src element of an embed tag and should not be the same as the content of the loc tag.
result.height string The height of the media object.
result.playerType string Player type that is required. For example: Flash or Silverlight.
result.width string The width of the media object.
result.thumbnail nested object Thumbnail image for an image or video.
result.caption string The caption for this object.
result.startDate string The start date and time of the event (in ISO 8601 date format).
result.endDate string The end date and time of the event (in ISO 8601 date format).
result.attendees[] list A person attending the event.
result.attendeeCount integer Number of attendees.
result.location nested object The location of the event or organization.
result.performers[] list The main performer or performers of the event-for example, a presenter, musician, or actor.
result.tickerSymbol string The exchange traded instrument associated with a Corporation object. The tickerSymbol is expressed as an exchange and an instrument name separated by a space character. For the exchange component of the tickerSymbol attribute, we reccommend using the controlled vocaulary of Market Identifier Codes (MIC) specified in ISO15022.
result.additionalName[] list An additional name for a Person, can be used for a middle name.
result.birthDate string Date of birth.
result.familyName string Family name. This property can be used with givenName instead of the name property.
result.gender string Gender of the person.
result.givenName string Given name. This property can be used with familyName instead of the name property.
result.text string The text that is the result of the app activity. For example, if a user leaves a review of a restaurant, this might be the text of the review.
result.reviewRating nested object Review rating.
result.ratingValue string Rating value.
result.bestRating string Best possible rating value that a result might obtain. This property defines the upper bound for the ratingValue. For example, you might have a 5 star rating scale, you would provide 5 as the value for this property.
result.worstRating string Worst possible rating value that a result might obtain. This property defines the lower bound for the ratingValue.
result.address nested object Postal address.
result.addressCountry string Address country.
result.addressLocality string Address locality.
result.addressRegion string Address region.
result.postOfficeBoxNumber string Post office box number.
result.postalCode string Postal code.
result.streetAddress string Street address.
result.geo nested object Geo coordinates.
result.latitude double Latitude.
result.longitude double Longitude.
result.inAlbum nested object From http://schema.org/MusicRecording, which album a song is in.
result.audio nested object From http://schema.org/MusicRecording, the audio file.
result.byArtist nested object From http://schema.org/MusicRecording, the artist that performed this recording.
result.partOfTVSeries nested object Property of http://schema.org/TVEpisode indicating which series the episode belongs to.
startDate datetime Time stamp of when the action occurred in RFC3339 format. writable
id string The moment ID.

Methods

insert
Record a moment representing a user's activity such as making a purchase or commenting on a blog. Writing moments involves specifying the type, which is a moment type, and posting that type of moment's required fields.
list
List all of the moments that your app has written for the authenticated user.
remove
Delete a moment that your app has written for the authenticated user.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.