Status von Änderungen an Standorten und Attributen prüfen

Wenn Sie Informationen zum Unternehmen über die My Business Business Information API oder die Benutzeroberfläche des Unternehmensprofils aktualisieren, werden die Änderungen moderiert und überprüft, bevor sie in der Google Suche und auf Google Maps veröffentlicht werden. Außerdem kann Google Unternehmensdetails anhand von Nutzermeldungen oder lizenzierten Datenquellen aktualisieren.

Mit den v1alpha-Endpunkten zum Bearbeitungsstatus können Sie eine einheitliche Ansicht eines Standorts oder seiner Attribute in einer einzigen Anfrage abrufen:

  • Vom Händler bereitgestellte Daten: Die zuletzt vom Händler eingereichten Werte.
  • Daten für Nutzer: Die Werte werden in der Google Suche und auf Google Maps angezeigt.
  • Erweiterte Feldmetadaten: Bearbeitungsstatus pro Feld oder Attribut, einschließlich der Lebenszyklusphase der letzten Bearbeitung, der Ursprungsquelle (API oder UI), des Zeitstempels der letzten Bearbeitung und des Grundes für einen Richtlinienverstoß, falls eine Bearbeitung abgelehnt wurde.

Hinweis

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

Erweiterte Standortdaten abrufen

Wenn Sie die vom Händler bereitgestellten Standortdaten, die für Verbraucher sichtbaren Standortdaten und den Bearbeitungsstatus pro Feld für einen Standort prüfen möchten, rufen Sie locations.getExtended auf.

Im Gegensatz zu locations.get ist für locations.getExtended kein readMask-Parameter erforderlich und es wird die vollständige ExtendedLocation-Ressource zurückgegeben.

Anfrage

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}:getExtended

Antwort

Die Antwort enthält drei Felder auf oberster Ebene:

  • locationProvidedByMerchant: Die Location-Daten, die vom Händler verwaltet werden.
  • locationSeenByConsumers: Die Location-Daten, die für Nutzer in der Google Suche und auf Google Maps sichtbar sind.
  • extendedFieldData: Eine Zuordnung von Location-Feldnamen der obersten Ebene in snake_case (z. B. title, phone_numbers, website_uri, storefront_address oder regular_hours) zu ExtendedFieldData-Objekten. Schlüssel sind immer einfache Feldnamen auf oberster Ebene, niemals verschachtelte Unterfelder.
{
  "locationProvidedByMerchant": {
    "name": "locations/{locationId}",
    "title": "Example Coffee Roasters - Best Coffee in Sydney",
    "phoneNumbers": {
      "primaryPhone": "02 5550 1234"
    },
    "websiteUri": "https://www.example.com/"
  },
  "locationSeenByConsumers": {
    "name": "locations/{locationId}",
    "title": "Example Coffee Roasters",
    "phoneNumbers": {
      "primaryPhone": "+61 2 5550 1234"
    },
    "websiteUri": "https://www.example.com/"
  },
  "extendedFieldData": {
    "title": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_REJECTED",
      "rejectionReason": "MISREPRESENTATION",
      "updateTime": "2026-09-25T08:00:00Z",
      "source": "SOURCE_API"
    },
    "phone_numbers": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE",
      "updateTime": "2026-09-20T14:15:00Z",
      "source": "SOURCE_UI"
    },
    "website_uri": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_ACCEPTED",
      "updateTime": "2026-09-15T10:30:00Z",
      "source": "SOURCE_API"
    }
  }
}

Erweiterte Attributdaten abrufen

Wenn Sie die vom Händler angegebenen Werte, die für Nutzer sichtbaren Werte und den Bearbeitungsstatus für die Attribute eines Standorts prüfen möchten, rufen Sie locations.attributes.getExtended auf.

Anfrage

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}/attributes:getExtended

Antwort

Die Antwort gibt eine ExtendedAttributes-Ressource mit einer Liste von ExtendedAttribute-Einträgen zurück. In jedem Eintrag werden attributeProvidedByMerchant und attributeSeenByConsumers mit einem extendedFieldData-Objekt für dieses Attribut verknüpft:

{
  "name": "locations/{locationId}/attributes",
  "extendedAttributes": [
    {
      "attributeProvidedByMerchant": {
        "name": "attributes/has_wheelchair_accessible_entrance",
        "valueType": "BOOL",
        "values": [
          true
        ]
      },
      "attributeSeenByConsumers": {
        "name": "attributes/has_wheelchair_accessible_entrance",
        "valueType": "BOOL",
        "values": [
          true
        ]
      },
      "extendedFieldData": {
        "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_ACCEPTED",
        "updateTime": "2026-09-10T12:00:00Z",
        "source": "SOURCE_API"
      }
    },
    {
      "attributeProvidedByMerchant": {
        "name": "attributes/wi_fi",
        "valueType": "ENUM",
        "values": [
          "free_wi_fi"
        ]
      },
      "attributeSeenByConsumers": {
        "name": "attributes/wi_fi",
        "valueType": "ENUM",
        "values": [
          "paid_wi_fi"
        ]
      },
      "extendedFieldData": {
        "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_PENDING",
        "updateTime": "2026-09-28T16:45:00Z",
        "source": "SOURCE_API"
      }
    }
  ]
}

Erweiterte Feldmetadaten

Jedes ExtendedFieldData-Objekt enthält die folgenden Felder:

Feld Typ Beschreibung
lastEditLifecycleStage EditLifecycleStage Der Moderations- oder Bereitstellungsstatus der letzten Änderung an diesem Feld oder Attribut.
rejectionReason PolicyViolation Der Richtlinienverstoß, der zur Ablehnung der Änderung geführt hat. Wird ausgefüllt, wenn lastEditLifecycleStage EDIT_LIFECYCLE_STAGE_REJECTED ist.
updateTime string (Timestamp) Der Zeitstempel, der angibt, wann die letzte Änderung an diesem Feld oder Attribut eingereicht wurde (RFC 3339-Format).
source Source Die ursprüngliche Oberfläche, auf der der Händler die Änderung eingereicht hat (SOURCE_API oder SOURCE_UI).

Lebenszyklusphasen bearbeiten

Die Aufzählung EditLifecycleStage gibt an, wo sich eine Änderung in ihrem Lebenszyklus befindet:

Wert Beschreibung Empfohlene Maßnahmen
EDIT_LIFECYCLE_STAGE_ACCEPTED Die Änderung des Händlers wurde genehmigt und kann ausgeliefert werden. Nicht erforderlich.
EDIT_LIFECYCLE_STAGE_PENDING Die Änderung des Händlers wird überprüft und wurde noch nicht auf den für Verbraucher sichtbaren Eintrag angewendet. Warten Sie, bis die Moderation abgeschlossen ist. Reichen Sie nicht wiederholt identische Änderungen ein, während eine Änderung aussteht.
EDIT_LIFECYCLE_STAGE_REJECTED Die Änderung des Händlers wurde nicht akzeptiert. Prüfen Sie rejectionReason auf den spezifischen PolicyViolation-Wert. Beheben Sie den zugrunde liegenden Richtlinienverstoß und reichen Sie ein neues Update mit locations.patch oder locations.updateAttributes ein.
EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE Der für Verbraucher sichtbare Wert wurde von Google aktualisiert (z. B. anhand von Nutzerberichten oder externen Quellen) und weicht vom Wert des Händlers ab. Prüfen Sie den Wert locationSeenByConsumers oder attributeSeenByConsumers und akzeptieren oder überschreiben Sie ihn. Weitere Informationen
EDIT_LIFECYCLE_STAGE_DRAFT Die Änderung wurde als Entwurf gespeichert (z. B. für einen nicht bestätigten Standort) und ist in der Google Suche und auf Google Maps nicht zu sehen. Schließen Sie die Standortbestätigung ab, damit der Eintrag veröffentlicht werden kann.
EDIT_LIFECYCLE_STAGE_UNSPECIFIED Die Lebenszyklusphase der Bearbeitung ist unbekannt oder nicht angegeben. Keine.

Quellen bearbeiten

Die Aufzählung Source gibt den Kanal an, über den der Händler die Änderung eingereicht hat:

  • SOURCE_API: Die Änderung wurde über die My Business Business Information API eingereicht.
  • SOURCE_UI: Die Änderung wurde über die Web-UI oder die mobile App des Unternehmensprofils eingereicht.
  • SOURCE_UNSPECIFIED: Die Quelle der Änderung ist nicht angegeben.

Richtlinienverstöße

Wenn lastEditLifecycleStage den Wert EDIT_LIFECYCLE_STAGE_REJECTED hat, enthält das Feld rejectionReason einen PolicyViolation-Enum-Wert, der erklärt, warum die Änderung abgelehnt wurde. Ablehnungsgründe umfassen die folgenden Bereiche (Beispiele):

  • Profil- und Kontostatus: ACCOUNT_RESTRICTED_AND_SUSPENDED, ACCOUNT_RESTRICTED_AND_EDIT_REJECTED, ASSOCIATED_ACCOUNT_SUSPENDED, BUSINESS_INELIGIBLE, LOCATION_SUSPENDED, LOCATION_VERIFICATION_REQUIRED, OWNERSHIP_REVOKED, PO_BOX.
  • Bearbeitungseinschränkungen: EDITING_RESTRICTION, ILLEGAL_BUSINESS_HOURS_EDIT, IDENTITY_CHANGE, GEOGRAPHIC_LOCATION_CHANGE.
  • Inhaltsrichtlinien: MISREPRESENTATION, OFF_TOPIC, PERSONAL_INFO, GIBBERISH_AND_REPETITIVE, OBSCENITY_AND_PROFANITY, GENERIC_QUALITY.

Eine vollständige Liste der Enum-Werte und Beschreibungen finden Sie in der Referenzdokumentation zu PolicyViolation.