REST Resource: accounts.locations.reviews

Ресурс: Обзор

Только для вывода. Представляет собой отзыв о конкретном месте.

JSON-представление 
{
  "name": string,
  "reviewId": string,
  "reviewer": {
    object (Reviewer)
  },
  "starRating": enum (StarRating),
  "comment": string,
  "createTime": string,
  "updateTime": string,
  "reviewReply": {
    object (ReviewReply)
  },
  "reviewMediaItems": [
    {
      object (ReviewMediaItem)
    }
  ]
}
Поля
name

string

Название ресурса. Для раздела «Отзывы» оно имеет вид accounts/{accountId}/locations/{locationId}/reviews/{reviewId}

reviewId

string

Зашифрованный уникальный идентификатор.

reviewer

object ( Reviewer )

Автор рецензии.

starRating

enum ( StarRating )

Рейтинг отзыва в виде звезд.

comment

string

Текст рецензии представлен в виде обычного текста с пометками.

createTime

string ( Timestamp format)

Отметка времени написания отзыва.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

updateTime

string ( Timestamp format)

Отметка времени последнего изменения отзыва.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

reviewReply

object ( ReviewReply )

Ответ владельца/управляющего данного заведения на этот отзыв.

reviewMediaItems[]

object ( ReviewMediaItem )

Только выходные данные. Медиаматериалы, связанные с обзором.

Рецензент

Представляет автора обзора.

JSON-представление 
{
  "profilePhotoUrl": string,
  "displayName": string,
  "isAnonymous": boolean
}
Поля
profilePhotoUrl

string

Ссылка на фотографию профиля рецензента. Заполняется только в том случае, если isAnonymous имеет значение false.

displayName

string

Имя рецензента. Заполняется настоящим именем рецензента только в том случае, если isAnonymous имеет значение false.

isAnonymous

boolean

Указывает, решил ли рецензент остаться анонимным.

Рейтинг звезд

Оценка по пятибалльной шкале, где пять — наивысший балл.

Перечисления
STAR_RATING_UNSPECIFIED Не указан.
ONE Одна звезда из максимально возможных пяти.
TWO Две звезды из пяти возможных.
THREE Три звезды из пяти возможных.
FOUR Четыре звезды из пяти возможных.
FIVE Максимальное количество звезд.

Ответить на отзыв

Представляет собой ответ владельца/менеджера заведения на отзыв.

JSON-представление 
{
  "comment": string,
  "updateTime": string,
  "reviewReplyState": enum (State),
  "policyViolation": enum (PolicyViolation)
}
Поля
comment

string

Текст ответа представлен в виде обычного текста с разметкой. Максимальная длина — 4096 байт.

updateTime

string ( Timestamp format)

Только вывод. Отметка времени последнего изменения ответа.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

reviewReplyState

enum ( State )

Только вывод. Состояние ответа на запрос.

policyViolation

enum ( PolicyViolation )

Необязательный параметр. Только для вывода. Нарушение правил, приведшее к отклонению. Заполняется только в том случае, если reviewReplyState имеет значение REJECTED.

Состояние

Отражает состояние модерации ответа на отзыв.

Перечисления
REVIEW_REPLY_STATE_UNSPECIFIED Указывает на то, что штат не указан.
PENDING Указывает на то, что ответ ожидает модерации.
REJECTED Указывает на то, что ответ был отклонен.
APPROVED Означает, что ответ был одобрен.

Нарушение политики

Представляет собой стандартные нарушения политики. В будущем могут быть добавлены новые значения. Клиенты должны быть готовы к работе с неизвестными значениями.

Перечисления
POLICY_VIOLATION_UNSPECIFIED Представляет собой неуказанное нарушение правил.
ACCOUNT_RESTRICTED_AND_SUSPENDED Связанный с этим бизнес-профилем аккаунт Google был заблокирован, что привело к приостановлению действия бизнес-профиля.
ACCOUNT_RESTRICTED_AND_EDIT_REJECTED Связанный с этим бизнес-профилем аккаунт Google был заблокирован, что приводит к отклонению правок. В отличие от ACCOUNT_RESTRICTED_AND_SUSPENDED, сам бизнес-профиль остается активным и не заблокирован.
ASSOCIATED_ACCOUNT_SUSPENDED Учетная запись Google, связанная с этим бизнес-профилем, имеет недопустимый статус. Бизнес-профили, связанные с этой учетной записью, были заблокированы.
BUSINESS_INELIGIBLE Ваша компания не имеет права на создание бизнес-профиля.
OWNERSHIP_REVOKED Другой аккаунт Google захватил этот бизнес-профиль. Вы больше не можете управлять этим профилем.
LOCATION_SUSPENDED Данный профиль компании заблокирован.
LOCATION_DISABLED Данный профиль компании отключен.
LOCATION_VERIFICATION_REQUIRED Данный бизнес-профиль не подтвержден.
PO_BOX Ваш бизнес-профиль заблокирован, поскольку в качестве адреса вашей компании нельзя использовать абонентский ящик.
GOOGLE_PAY_SUSPENSION Связанные с вашим платежным профилем бизнес-профили приостановлены.
EDITING_RESTRICTION В настоящее время доступ к этому бизнес-профилю ограничен. Google отключил возможность редактирования этого раздела, чтобы предотвратить размещение контента, нарушающего правила.
ILLEGAL_BUSINESS_HOURS_EDIT В категории вашего бизнеса нельзя редактировать часы работы.
FAKE_ENGAGEMENT Контент, нарушающий нашу политику в отношении фальсификации взаимодействия, не допускается. К фальсификации взаимодействия относятся контент, предлагающий вознаграждение, контент, предназначенный для манипулирования рейтингом сайта, и другой контент, не отражающий реальный опыт.
ADULT_THEMED Контент, нарушающий наши правила в отношении контента для взрослых, не допускается. К контенту для взрослых относятся как неявные сексуальные сцены, так и другие материалы для взрослых.
SEXUALLY_EXPLICIT Контент, нарушающий нашу политику в отношении материалов сексуального характера, не допускается. К материалам сексуального характера относятся изображения обнаженных гениталий, а также изображения или описания сексуальных действий.
ADVERTISING_AND_SOLICITATION Контент, нарушающий нашу политику в отношении рекламы и коммерческих предложений, не допускается. Реклама и коммерческие предложения включают в себя рекламный или продвиженческий контент, а также контент, размещаемый в обмен на получение выгоды.
DANGEROUS Контент, нарушающий наши правила в отношении опасного контента, не допускается. Опасный контент пропагандирует, способствует или поощряет противоправные действия.
GIBBERISH_AND_REPETITIVE Контент, нарушающий наши правила в отношении неясного или повторяющегося контента, не допускается. Неясный или повторяющийся контент снижает ценность полезной информации, которую другие пользователи могут найти в Google.
REPETITIVE Контент, нарушающий наши правила в отношении повторяющегося контента, не допускается. Повторяющийся контент включает в себя идентичный или похожий контент, добавляемый несколько раз с одного или нескольких аккаунтов.
UNCLEAR Контент, нарушающий наши правила в отношении непонятного контента, не допускается. К непонятному контенту относятся случайные символы или другой контент, лишенный смысла.
ILLEGAL Контент, нарушающий наши правила в отношении незаконного контента, не допускается.
OFF_TOPIC Контент, нарушающий наши правила в отношении контента, не относящегося к теме, не допускается. К контенту, не относящемуся к теме, относятся общие, политические или социальные комментарии, а также личные высказывания.
OFFENSIVE Контент, нарушающий наши правила в отношении оскорбительного контента, не допускается. Оскорбительный контент может обоснованно вызвать у другого человека сильный гнев, оскорбление или неуважение.
VIOLENCE_AND_GORE Контент, нарушающий наши правила в отношении насилия и жестокости, не допускается. Насилие и жестокость включают в себя контент с участием людей или животных, который носит экстремальный характер и изображает реалистичные акты насилия, кровь, части тела или внутренности.
CHILD_SAFETY Контент, нарушающий нашу политику в отношении безопасности детей, не допускается. Это включает в себя материалы, которые подвергают детей риску, эксплуатируют или жестоко обращаются с детьми, а также используют сервисы Google для создания угрозы для детей.
HARASSMENT Контент, нарушающий нашу политику в отношении домогательств, не допускается. Это включает в себя контент, содержащий издевательства, угрозы, сексуализацию или вызывающий у человека опасения за свою безопасность.
HATE_SPEECH Контент, нарушающий нашу политику в отношении разжигания ненависти, не допускается. К разжиганию ненависти относятся пропаганда или оправдание насилия, дискриминации, унижения или подстрекательство к ненависти на основе защищенных характеристик или других характеристик, связанных с системной дискриминацией или маргинализацией.
IMPERSONATION Контент, нарушающий нашу политику в отношении выдачи себя за другое лицо, не допускается. Выдача себя за другое лицо включает в себя присвоение ложной личности с целью ввести других в заблуждение или получить неправомерную выгоду.
MISINFORMATION Контент, нарушающий нашу политику в отношении дезинформации, не допускается. Дезинформация включает в себя ложную или неточную информацию, которая может нанести существенный вред отдельным лицам, предприятиям или обществу.
MISREPRESENTATION Контент, нарушающий нашу политику в отношении предоставления ложной информации, не допускается. Ложная информация включает в себя вводящие в заблуждение заявления или умолчания с целью получения неправомерной выгоды.
OBSCENITY_AND_PROFANITY Контент, нарушающий наши правила в отношении непристойности или ненормативной лексики, не допускается. К непристойности и ненормативной лексике относятся слова или жесты, которые в данном регионе считаются социально оскорбительными или вульгарными.
PERSONAL_INFO Контент, нарушающий нашу политику в отношении персональных данных, не допускается. К персональным данным относится частная или конфиденциальная информация, такая как данные кредитной карты, медицинские записи или удостоверения личности, выданные государственными органами, будь то ваши или чужие.
REGULATED_GOODS_AND_SERVICES Запрещено размещать контент, нарушающий нашу политику в отношении регулируемых товаров и услуг. Это включает в себя призывы к действию или предложения о продаже товаров или услуг, на которые распространяются местные правовые нормы.
GENERIC_VANDALISM Контент, нарушающий наши правила в отношении оскорбительного или низкокачественного контента, не допускается.
GENERIC_FRAUD Контент, нарушающий наши правила в отношении вводящего в заблуждение контента и поведения, не допускается. Вводящий в заблуждение контент намеренно вводит в заблуждение или обманывает других.
PHOTOS_AND_VIDEOS_CRITERIA Контент, не соответствующий нашим критериям для фото- и видеосъемки, не допускается.
MODERATION_ERROR При обработке вашего контента произошла ошибка.
PRIVACY Запрещено размещать контент, нарушающий политику конфиденциальности пользовательских карт.
GENERIC_VIOLATION Ваш контент нарушает наши правила и запрещен.
GENERIC_QUALITY Контент, нарушающий наши правила в отношении низкокачественного контента, не допускается.
IDENTITY_CHANGE Внесенные вами изменения существенно отличаются от созданного бизнеса. Это нарушает нашу политику.
GEOGRAPHIC_LOCATION_CHANGE Указывает на то, что физическое географическое местоположение компании (адрес или широта/долгота) существенно изменилось с момента создания профиля.

ReviewMediaItem

Представляет собой медиафайл (фото или видео), связанный с обзором.

JSON-представление 
{
  "thumbnailUrl": string,
  "thumbnailLabel": string,
  "videoUrl": string
}
Поля
thumbnailUrl

string

Только для вывода. URL-адрес FIFE для фотографии или миниатюра видео, если указан videoUrl .

thumbnailLabel

string

Только для вывода. Метка, предоставленная автором для thumbnailUrl .

videoUrl

string

Только вывод. URL воспроизводимого видео.

Методы

deleteReply

 Удаляет ответ на указанный отзыв.

get

 Возвращает указанный отзыв.

list

 Возвращает постраничный список отзывов для указанного местоположения.

updateReply

 Обновляет ответ на указанный отзыв.