Reviews

Update a review

Changed on

Update the state of a review to treated/not_treated

put/reviews/{review_id}

Request

Path parameters

review_idinteger required

Review id

Example:34

Request body

state'treated' | 'not_treated' required

Reply state

Response

OK

keystring

Identifier of the review on the partner platform. For a review pushed through a custom partner, this is the external_id you sent.

org_idinteger

Unique identifier of an organization in Partoo.

idinteger

Review id

business_idstring

Business id

partnerstring

Review partner slug

partner_idstring

Review id on publisher

author_namestring

The author name of the review.

Note: Replies don't have an author.

datestring datetime

Review creation date

update_datestring datetime

Review update date

delete_datestring datetime

Review deletion date (only specified if the review has been deleted)

ratinginteger

Review rating (can be null)

recommendedboolean

Review recommended (can be null)

titlestring

Review title

contentstring

Review body content

state'treated' | 'not_treated' | 'deleted'

Reply state

linkstring uri

Link to review on publisher platform

media_linksstring[]

Array of Google photo URLs associated with the review.

Populated when with_media_links=true query parameter is used. Empty array if no associated media found or if with_media_links=false.

Example response

{
  "org_id": 42,
  "id": 34,
  "business_id": "5409c35a97bbc544d8e26737",
  "partner": "google_my_business",
  "partner_id": "accounts/114063712393225091258/locations/74805271119400652054",
  "author_name": "Castorche",
  "date": "2017-07-01T16:10:23.156000+02:00",
  "update_date": "2017-08-01T19:15:54.256000+02:00",
  "rating": 3,
  "content": "Magasin un peu vieillot , mais personnel très sympathique, nombreuses références en rayons , un très bon choix côté vin...",
  "state": "treated",
  "comments": [
    {
      "id": 82938,
      "partner_id": "accounts/114063712393225091258/locations/74805271119400652054",
      "created": "2019-08-01T19:15:54.256000+02:00",
      "author_name": "Castorche",
      "content": "Merci ❤️",
      "date": "2017-08-01T19:15:54.256000+02:00",
      "update_date": "2017-08-01T19:15:54.256000+02:00",
      "can_edit": true,
      "review_id": 34,
      "user_id": "123456789abcdef2f60c42ff"
    }
  ],
  "tags": [
    {
      "id": 25,
      "label": "food",
      "color": "#808080"
    }
  ],
  "media_links": [
    "https://lh3.googleusercontent.com/gpms...",
    "https://lh3.googleusercontent.com/gpms-cs-s/AB8u6HYwO..."
  ]
}

Changes

    • breaking

      the //// response's property type changed from object to array for status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • info

      removed the facebook enum value from the //// response property for the response status

    • info

      removed the google_my_business enum value from the //// response property for the response status

    • info

      removed the tripadvisor enum value from the //// response property for the response status