Die Verifications API und die Business Information API sind jetzt verfügbar. Es sind Migrationen erforderlich. Weitere Informationen zu verworfenen Endpunkten finden Sie in unserem Zeitplan für Einstellungen. Sie können sich auch auf die Mailingliste setzen lassen, um entsprechende Benachrichtigungen zu erhalten.

Mit Rezensionsdaten arbeiten

In dieser Anleitung erfahren Sie, wie Sie Rezensionen aufrufen, zurückgeben, beantworten und löschen können. Mit der Google My Business API können Sie Rezensionsdaten nutzen, um Folgendes zu tun:

Hinweis

Sie können die Google My Business API erst verwenden, nachdem Sie Ihre Anwendung registriert und OAuth 2.0-Anmeldedaten abgerufen haben. Weitere Informationen zu den ersten Schritten mit der Google My Business API finden Sie unter Grundlegende Einrichtung.

Alle Rezensionen abrufen

Mit der accounts.locations.reviews.list API können Sie alle Rezensionen für einen Standort abrufen, um sie im Bulk-Verfahren zu prüfen.

Verwenden Sie folgenden Code, um alle Rezensionen für einen Standort abzurufen:

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

Die folgende Funktion verwendet 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 = accountsList.execute();
  List<Reviews> reviews = response.getReviews();

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

Eine bestimmte Rezension abrufen

Mit der accounts.locations.reviews.get API können Sie eine bestimmte Rezension für einen Standort anhand seines Namens abrufen.

Verwenden Sie folgenden Code, um eine bestimmte Rezension abzurufen:

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

Die folgende Funktion verwendet 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;
}

Zusätzliche Daten

Die Java-Clientbibliothek bietet Zugriff auf zusätzliche Felddaten für Rezensionsinstanzen. Sie können die folgenden Methoden verwenden, um zusätzliche Daten zu Rezensionen abzurufen:

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

Rezensionen für mehrere Standorte abrufen

Mit der accounts.locations.batchGetReviews API können Sie Rezensionen für verschiedene Standorte in einer Anfrage abrufen.

Verwenden Sie folgenden Code, um Rezensionen für verschiedene Standorte abzurufen:

HTTP

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

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

Auf eine Rezension antworten

Sie können auf eine bestimmte Rezension antworten oder eine neue Antwort verfassen, wenn noch keine vorhanden ist. Verwenden Sie die accounts.locations.reviews.updateReply API, um auf eine bestimmte Rezension für einen Standort zu antworten.

Verwenden Sie folgenden Code, um auf eine bestimmte Rezension zu antworten:

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

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

Die folgende Funktion verwendet 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  = reviewReply.execute();

  return response;
}

Antworten auf Rezensionen löschen

Mit der accounts.locations.reviews.deleteReply API können Sie eine Antwort auf eine bestimmte Rezension für einen Standort löschen.

Verwenden Sie folgenden Code, um eine bestimmte Antwort auf eine Rezension zu löschen:

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

Die folgende Funktion verwendet 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;
}