Lavorare con i dati delle recensioni

Questo tutorial ti mostra come elencare, restituire, rispondere ed eliminare una recensione. L'API Google My Business ti consente di utilizzare i dati delle recensioni per eseguire le seguenti operazioni:

Prima di iniziare

Prima di utilizzare l'API Google My Business, devi registrare la tua applicazione e ottenere le credenziali OAuth 2.0. Per informazioni dettagliate su come iniziare a utilizzare l'API Google My Business, consulta Configurazione di base.

Elencare tutte le recensioni

Elenca tutte le recensioni di una sede per controllarle in blocco. Utilizza l' accounts.locations.reviews.list per restituire tutte le recensioni associate a una sede.

Per restituire tutte le recensioni associate a una sede:

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews
Java

La seguente funzione utilizza Mybusiness.Accounts.Locations.Reviews.List.

/**
 * Returns a list of reviews.
 * @param locationName Name of the location to retrieve reviews for.
 * @return List<Reviews> A list of reviews.
 * @throws Exception
 */
public static List<Review> listReviews(String locationName) throws Exception {
  Mybusiness.Accounts.Locations.Reviews.List reviewsList =
    mybusiness.accounts().locations().reviews().list(locationName);
  ListReviewsResponse response = reviewsList.execute();
  List<Reviews> reviews = response.getReviews();

  for (Reviews review : reviews) {
    System.out.println(review.toPrettyString());
  }
  return reviews;
}

Ottenere una recensione specifica

Restituisci una recensione specifica per nome. Utilizza l' accounts.locations.reviews.get per restituire una recensione specifica associata a una sede.

Per restituire una recensione specifica:

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews/{reviewId}
Java

La seguente funzione utilizza Mybusiness.Accounts.Locations.Reviews.Get.

/**
 * Demonstrates getting a review by name.
 * @param reviewName The name (resource path) of the review to retrieve.
 * @return Account The requested review.
 */
private static Review getReview(String reviewName) throws Exception {
  Mybusiness.Accounts.Locations.Reviews.Get review =
      mybusiness.accounts().locations().reviews().get(reviewName);
  Review response = review.execute();

  return response;
}

Dati aggiuntivi

La libreria client Java ti consente di accedere ai dati dei campi aggiuntivi per le istanze di recensione. Utilizza i seguenti metodi per restituire dati aggiuntivi sulle recensioni:

  • getReviewId()
  • getComment()
  • getReviewer()
  • getStarRating()
  • getCreateTime()
  • getReviewReply()

Ottenere recensioni da più sedi

Ottieni recensioni da più sedi. Utilizza l' accounts.locations.batchGetReviews per restituire le recensioni da più sedi in un'unica richiesta.

Per restituire le recensioni da più sedi:

HTTP

POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations:batchGetReviews

{
  "locationNames": [
    string
  ],
  "pageSize": number,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}

Rispondere a una recensione

Rispondi a una recensione specifica o crea una nuova risposta se non ne esiste una. Utilizza l' accounts.locations.reviews.updateReply per rispondere a una recensione specifica associata a una sede.

Per rispondere a una recensione specifica:

HTTP
PUT
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews/{reviewId}/reply

{
  "comment": "Thank you for visiting our business!"
}
Java

La seguente funzione utilizza Mybusiness.accounts.locations.reviews.reply.

/*
 * Updates the reply for a location review.
 * If a review does not exist, creates a new one.
 * @param reviewName Name of the review being responded to.
 * @param comment A string containing the review response body.
 * @throws IOException
 */
private static Reply reply(String reviewName, String comment) throws IOException {

  MyBusiness.Accounts.Locations.Reviews.Reply reply =
    mybusiness().accounts().locations().reviews().reply(reviewName, comment);

  Reply response  = reply.execute();

  return response;
}

Eliminare una risposta a una recensione

Elimina una risposta a una recensione specifica. Utilizza l' accounts.locations.reviews.deleteReply per eliminare una risposta a una recensione specifica associata a una sede.

Per eliminare una risposta specifica a una recensione:

HTTP
DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews/{reviewId}/reply
Java

La seguente funzione utilizza Mybusiness.Accounts.Locations.Reviews.DeleteReply.

/**
 * Demonstrates deleting a review reply by name.
 * @param reviewName The name (resource path) of the review reply to delete.
 * @return Account The requested review.
 */
private static DeleteReply deleteReply(String reviewName) throws Exception {
  Mybusiness.Accounts.Locations.Reviews.DeleteReply toDelete =
      mybusiness.accounts().locations().reviews().deleteReply(reviewName);
  DeleteReply response = toDelete.execute();

  return response;
}