Konumlar ve özellikler için düzenleme durumunu kontrol etme

İşletme bilgilerini My Business Business Information API veya İşletme Profili kullanıcı arayüzü üzerinden güncellediğinizde, düzenlemeler Google Arama ve Haritalar'da yayınlanmadan önce bir moderasyon ve doğrulama sürecinden geçer. Ayrıca Google, kullanıcı raporlarına veya lisanslı veri kaynaklarına göre işletme bilgilerini güncelleyebilir.

v1alpha Düzenleme Durumu uç noktaları, tek bir istekte bir konumun veya özelliklerinin birleştirilmiş görünümünü almanıza olanak tanır:

  • Satıcı tarafından sağlanan veriler: Satıcı tarafından en son gönderilen değerler.
  • Tüketicilere yönelik veriler: Değerler Google Arama ve Haritalar'da yayınlanır.
  • Genişletilmiş alan meta verileri: En son düzenlemenin yaşam döngüsü aşaması, kaynak (API veya UI), son düzenlemenin zaman damgası ve düzenleme reddedildiyse politika ihlali nedeni dahil olmak üzere alan veya özellik başına düzenleme durumu.

Başlamadan önce

My Business Business Information API'yi kullanmadan önce uygulamanızı kaydedin ve OAuth 2.0 kimlik bilgilerini alın. Nasıl başlayacağınızla ilgili ayrıntılar için Temel kurulum başlıklı makaleyi inceleyin.

Genişletilmiş konum verilerini alma

Satıcı tarafından sağlanan konum verilerini, tüketiciye yönelik konum verilerini ve bir konumun alan bazında düzenleme durumunu incelemek için locations.getExtended yöntemini çağırın.

locations.get yönteminin aksine locations.getExtended, readMask parametresi gerektirmez ve tam ExtendedLocation kaynağını döndürür.

İstek

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

Yanıt

Yanıt, üç üst düzey alan içerir:

  • locationProvidedByMerchant: Satıcı tarafından yönetilen Location verileri.
  • locationSeenByConsumers: Tüketicilerin Google Arama ve Haritalar'da görebileceği Location verileri.
  • extendedFieldData: snake_case içindeki üst düzey Location alan adlarının (title, phone_numbers, website_uri, storefront_address veya regular_hours gibi) ExtendedFieldData nesnelerine eşlemesi. Anahtarlar her zaman düz üst düzey alan adlarıdır, hiçbir zaman iç içe yerleştirilmiş alt alanlar değildir.
{
  "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"
    }
  }
}

Genişletilmiş özellik verilerini alma

Bir konumun özelliklerine ait satıcı tarafından sağlanan değerleri, tüketiciye yönelik değerleri ve düzenleme durumunu incelemek için locations.attributes.getExtended yöntemini çağırın.

İstek

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

Yanıt

Yanıt, ExtendedAttribute girişlerinin listesini içeren bir ExtendedAttributes kaynağı döndürür. Her giriş, attributeProvidedByMerchant ve attributeSeenByConsumers değerlerini bu özelliğin extendedFieldData nesnesiyle eşleştirir:

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

Genişletilmiş alan meta verilerini anlama

Her ExtendedFieldData nesnesi aşağıdaki alanları içerir:

Alan Tür Açıklama
lastEditLifecycleStage EditLifecycleStage Bu alanda veya özellikte yapılan en son düzenlemenin denetleme ya da yayınlanma durumu.
rejectionReason PolicyViolation Düzenlemenin reddedilmesine neden olan politika ihlali. lastEditLifecycleStage, EDIT_LIFECYCLE_STAGE_REJECTED olduğunda doldurulur.
updateTime string (Timestamp) Bu alanda veya özellikte yapılan son düzenlemenin gönderildiği zaman damgası (RFC 3339 biçimi).
source Source Satıcının düzenlemeyi gönderdiği kaynak yüzey (SOURCE_API veya SOURCE_UI).

Yaşam döngüsü aşamalarını düzenleme

EditLifecycleStage enum'u, bir düzenlemenin yaşam döngüsünün neresinde olduğunu gösterir:

Değer Açıklama Önerilen işlem
EDIT_LIFECYCLE_STAGE_ACCEPTED Satıcının düzenlemesi onaylandı ve yayınlanmaya uygun. Hiçbir işlem gerekli değil.
EDIT_LIFECYCLE_STAGE_PENDING Satıcının düzenlemesi inceleniyor ve tüketiciye yönelik girişe uygulanmadı. Denetimin tamamlanmasını bekleyin. Bir düzenleme beklemedeyken aynı düzenlemeleri tekrar tekrar göndermeyin.
EDIT_LIFECYCLE_STAGE_REJECTED Satıcının düzenlemesi kabul edilmedi. Belirli PolicyViolation değeri için rejectionReason sayfasını kontrol edin. Temel politika ihlalini düzeltin ve locations.patch veya locations.updateAttributes kullanarak yeni bir güncelleme gönderin.
EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE Tüketiciye yönelik değer Google tarafından güncellenmiştir (ör. kullanıcı raporlarından veya harici kaynaklardan) ve satıcı tarafından sağlanan değerden farklıdır. locationSeenByConsumers veya attributeSeenByConsumers değerini inceleyin ve kabul edin ya da geçersiz kılın. Google güncellemelerini yönetme başlıklı makaleyi inceleyin.
EDIT_LIFECYCLE_STAGE_DRAFT Düzenleme taslak olarak kaydedilmiştir (ör. doğrulanmamış bir konumda) ve Google Arama ile Haritalar'da yayınlanmamıştır. Girişin yayınlanabilmesi için konum doğrulamasını tamamlayın.
EDIT_LIFECYCLE_STAGE_UNSPECIFIED Düzenlemenin yaşam döngüsü aşaması bilinmiyor veya belirtilmemiş. Yok.

Kaynakları düzenleme

Source enum, satıcının düzenlemeyi gönderdiği kanalı tanımlar:

  • SOURCE_API: Düzenleme, My Business Business Information API aracılığıyla gönderildi.
  • SOURCE_UI: Düzenleme, İşletme Profili web kullanıcı arayüzü veya mobil uygulaması üzerinden gönderildi.
  • SOURCE_UNSPECIFIED: Düzenlemenin kaynağı belirtilmemiş.

Politika ihlalleri

lastEditLifecycleStage, EDIT_LIFECYCLE_STAGE_REJECTED olduğunda rejectionReason alanı, düzenlemenin neden reddedildiğini açıklayan bir PolicyViolation enum değeri sağlar. Reddedilme nedenleri aşağıdaki alanları kapsar (örnekler):

  • Profil ve hesap durumu: ACCOUNT_RESTRICTED_AND_SUSPENDED, ACCOUNT_RESTRICTED_AND_EDIT_REJECTED, ASSOCIATED_ACCOUNT_SUSPENDED, BUSINESS_INELIGIBLE, LOCATION_SUSPENDED, LOCATION_VERIFICATION_REQUIRED, OWNERSHIP_REVOKED, PO_BOX.
  • Düzenleme kısıtlamaları: EDITING_RESTRICTION, ILLEGAL_BUSINESS_HOURS_EDIT, IDENTITY_CHANGE, GEOGRAPHIC_LOCATION_CHANGE.
  • İçerik politikaları: MISREPRESENTATION, OFF_TOPIC, PERSONAL_INFO, GIBBERISH_AND_REPETITIVE, OBSCENITY_AND_PROFANITY, GENERIC_QUALITY.

Numaralandırma değerlerinin ve açıklamalarının tam listesi için PolicyViolation referans belgelerine bakın.