Signaler un contenu inapproprié

L'API Places renvoie des informations sur un lieu dans une réponse. En plus des informations factuelles, telles qu'une adresse et un numéro de téléphone, la réponse peut également contenir des contenus que les utilisateurs ont ajoutés sur Google Maps, comme des avis et des photos. De plus, lorsque vous utilisez les fonctionnalités de modèle Gemini pour l'API Places, la réponse peut inclure des données génératives agrégées et résumées à partir d'un LLM.

Bien que Google ait mis en place une série de mesures pour identifier les contenus problématiques avant qu'ils ne soient renvoyés par l'API Places, nous permettons également aux utilisateurs de signaler les contenus inappropriés afin que Google puisse les supprimer. Avec cette version, l'API Places inclut le nouveau champ flagContentUri dans tous les avis, photos et résumés génératifs inclus dans une réponse de l'API Places. Ce champ contient un lien, y compris un identifiant de contenu unique, qui permet aux utilisateurs de signaler à Google un contenu inapproprié.

Par exemple, vous envoyez une requête qui renvoie cinq avis individuels pour un établissement. Chaque avis individuel inclut le nouveau champ flagContentUri avec un identifiant unique pour cet avis afin qu'un utilisateur puisse signaler un problème avec l'un ou l'ensemble des avis.

API Explorer vous permet d'envoyer des requêtes en direct afin de vous familiariser avec ces nouvelles options:

Essayer

L'URL contenue dans le champ flagContentUri inclut un identifiant unique pour le contenu. Si vous accédez à ce lien, une page Web hébergée par Google s'ouvre sous la forme suivante:

Page Web permettant de signaler un problème.

Dans cette boîte de dialogue, vos utilisateurs peuvent envoyer un rapport à Google pour le type de problème approprié. Par exemple, ils peuvent signaler un contenu contenant des jurons, de l'intimidation ou un problème juridique.

Tarifs

Cette fonctionnalité est en phase de pré-disponibilité générale et son utilisation est sans frais pendant la phase de preview (facturation de 0 $). Pour en savoir plus sur les tarifs proposés, consultez la section Utilisation et facturation de l'API Places.

Afficher le lien de signalement du contenu

Cette version Preview ajoute le nouveau champ flagContentUri aux objets suivants qui font déjà partie de la réponse de l'API Places:

  • Review
  • Photo

  • GenerativeSummary Pour GenerativeSummary uniquement, deux nouveaux champs sont disponibles:

    • overviewFlagContentUri: lien permettant de signaler à Google un contenu inapproprié dans la vue d'ensemble.
    • descriptionFlagContentUri: lien permettant de signaler à Google un contenu inapproprié dans la description.

  • AreaSummary

  • ContextualContent

Pendant la période de prévisualisation, vous n'êtes pas tenu d'afficher le lien de signalement de contenu lorsque vous présentez ces objets à vos clients.

Toutefois, lorsque cette fonctionnalité sera disponible en général, vous devrez afficher le lien de signalement de contenu lorsque vous afficherez ces objets afin que vos clients puissent signaler tout problème de contenu.

Accéder au lien de signalement du contenu dans la réponse

La requête d'informations sur un lieu suivante inclut les avis sur le lieu dans la réponse:

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

La réponse se présente sous la forme suivante:

{
  "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"
    },
    …
  ]
}

Chaque entrée du tableau reviews contient le champ flagContentUri, y compris un identifiant unique pour cet avis spécifique. En cliquant sur ce lien, vos clients peuvent signaler un contenu inapproprié pour cet avis spécifique.

Si vous incluez photos dans le masque de champ:

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

La réponse inclut également le tableau photos, où chaque élément contient le champ 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"
    },
    ...
  ]

Les liens vers le contenu restent actifs jusqu'à ce que le contenu de base soit supprimé. Les liens continuent d'ouvrir la boîte de dialogue pour le contenu qui a été supprimé, mais le signalement d'un contenu déjà supprimé n'a aucun effet.

Essayer

API Explorer vous permet d'envoyer des exemples de requêtes afin de vous familiariser avec l'API et ses options.

  1. Sélectionnez l'icône API Développez l'explorateur d'API. sur le côté droit de la page.

  2. Vous pouvez également développer Afficher les paramètres standards et définir le paramètre fields sur le masque de champ.

  3. Modifiez éventuellement le corps de la requête.

  4. Sélectionnez le bouton Exécuter. Dans la boîte de dialogue, choisissez le compte que vous souhaitez utiliser pour effectuer la demande.

  5. Dans le panneau API Explorer, sélectionnez l'icône de développement, Développez l'explorateur d'API., pour développer la fenêtre API Explorer.