Denunciar conteúdo inadequado

A API Places (nova) retorna informações sobre um lugar em uma resposta. Além de conteúdo factual, como endereço e número de telefone, a resposta também pode conter conteúdo que os usuários contribuíram no Google Maps, como avaliações e fotos. Além disso, quando você usa os recursos do modelo do Gemini para a API Places (nova), a resposta pode incluir dados generativos agregados e resumidos de um LLM.

Embora o Google tenha implementado uma série de medidas para identificar conteúdo problemático antes que ele seja retornado pela API Places (nova), também oferecemos uma maneira de os usuários sinalizarem conteúdo inadequado para que o Google possa removê-lo. Com esta versão, a API Places (nova) inclui o novo campo flagContentUri em todas as avaliações, fotos e resumos generativos incluídos em uma resposta da API Places (nova). Esse campo contém um link, incluindo um identificador de conteúdo exclusivo, que permite que os usuários notifiquem o Google sobre conteúdo inadequado.

Por exemplo, você faz uma solicitação que retorna cinco avaliações individuais de um lugar. Cada avaliação individual inclui o novo campo flagContentUri com um identificador exclusivo para que um usuário possa informar um problema com uma ou todas as avaliações.

O API Explorer permite fazer solicitações em tempo real para que você se familiarize com essas novas opções:

Faça um teste

O URL contido no campo flagContentUri inclui um identificador exclusivo para o conteúdo. Ao acessar esse link, uma página da Web hospedada pelo Google é aberta no formulário:

A página da Web para informar um problema.

Nessa caixa de diálogo, os usuários podem enviar uma denúncia ao Google para o tipo de problema adequado. Por exemplo, eles podem denunciar linguagem obscena, bullying ou um problema legal com o conteúdo.

O campo flagContentUri está disponível nos seguintes objetos que já fazem parte da resposta da API Places (nova):

Você precisa exibir o link de denúncia de conteúdo ao mostrar esses objetos para que seus clientes possam denunciar qualquer problema de conteúdo.

A solicitação do Place Details (novo) a seguir inclui avaliações de lugares na resposta:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,reviews" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

A resposta está no formato:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  },
  "reviews": [
    {
      "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/ChdDjNnRRAB",
      "relativePublishTimeDescription": "7 months ago",
      "rating": 3,
      "text": {
        "text": "Came here for a tour and honestly,...",
        "languageCode": "en"
      },
      "originalText": {
        "text": "Came here for a tour and honestly,...",
        "languageCode": "en"
      },
      "authorAttribution": {
        "displayName": "John Smith",
        "uri": "https://www.google.com/maps/contrib/10198693/reviews",
        "photoUri": "https://lh3.googleusercontent.com/a-/A-c00-cc-rp-mo-ba6"
      },
      "publishTime": "2024-02-24T19:26:18.091264Z",
      "flagContentUri": "https://www.google.com/local/review/rap/report?postId=CJ2&t=1",
      "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5"
    },
    …
  ]
}

Cada entrada na matriz reviews contém o campo flagContentUri, incluindo um identificador exclusivo para essa avaliação específica. Ao acessar esse link, os clientes podem denunciar conteúdo inadequado para essa avaliação específica.

Se você incluir photos na máscara de campo:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,reviews,photos" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

A resposta também inclui a matriz photos, em que cada elemento contém o campo flagContentUri:

  ...
  "photos": [
    {
      "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/AdCG2DNmA4zTnu24VKCwSW7ulKkgDA8cTe5sz74Q4Doo",
      "widthPx": 4032,
      "heightPx": 3024,
      "authorAttributions": [
        {
          "displayName": "Jane Smith",
          "uri": "https://maps.google.com/maps/contrib/107007354",
          "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjXvHp8Kg932h80MpoDSJ_Sl4F-no-mo"
        }
      ],
      "flagContentUri": "https://www.google.com/local/imagery/report/?cb_client=maps_api_places&image_key=!1e10!2XtMU_GKr",
      "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5"
    },
    ...
  ]

Os links de conteúdo permanecem ativos até que o conteúdo de apoio seja removido. Os links continuam abrindo a caixa de diálogo para conteúdo que foi removido, mas registrar uma denúncia sobre conteúdo que já foi removido não tem efeito.

Confira!

O APIs Explorer permite que você faça solicitações de amostra para se familiarizar com a API e as opções dela.

  1. Selecione o ícone da API, Abra o APIs Explorer., no lado direito da página.

  2. Se quiser, expanda Mostrar parâmetros padrão e defina o parâmetro fields como a máscara de campo.

  3. Se quiser, edite o Corpo da solicitação.

  4. Selecione o botão Executar. Na caixa de diálogo, escolha a conta que você quer usar para fazer a solicitação.

  5. No painel do APIs Explorer, selecione o ícone de expansão Abra o APIs Explorer. para abrir a janela do APIs Explorer.