Google güncellemelerini yönetme

Google, İşletme Profilinizin olabildiğince doğru olmasını sağlamak için kullanıcı raporları ve lisanslı içerikler gibi kaynaklardan alınan bilgileri kullanır. İşletme sahipleri tarafından sağlanan bilgilerin yanlış olduğu bildirilirse Google, giriş sahiplerini bilgilendirir. Giriş sahipleri daha sonra güncellemeleri kabul edebilir veya reddedebilir.

Giriş sahibi olarak My Business Business Information API, işletme bilgilerinizin doğru olduğundan emin olmak için bu güncellemeleri incelemenize olanak tanır. Bu kılavuzda, güncellemelerin nasıl kabul edileceği veya reddedileceği açıklanmaktadır.

Google güncellemelerinizi yönetmek için aşağıdaki adımları uygulayın:

  1. Bekleyen güncellemeleri olan konumları bulma
  2. Güncellenen alanları inceleme
  3. Güncellemeleri kabul etme veya reddetme
  4. Sonuçları inceleme

Bekleyen güncellemeleri olan konumları bulma

Güncellemeleri kabul etmeden veya reddetmeden önce hangi konumlar için Google güncellemelerinin mevcut olduğunu öğrenmeniz gerekir. Konumlar için Google güncellemelerini almanın en iyi yolu, Cloud Pub/Sub ile anlık bildirimleri yönetmektir. Pub/Sub konunuzda bir GOOGLE_UPDATE bildirimi alırsanız incelemeniz için hazır bir değişiklik var demektir. Bildirimdeki locationName alanı, Google güncellemeleri içeren konumun kaynak adını sağlar.

Alternatif olarak, locations.get çağrısını görebilir ve hasGoogleUpdated işaretinin varlığı için Metadata öğesini inceleyebilirsiniz. "isGoogleUpdated": true ise bu konumla ilişkili yer kimliğinde güncellemeler vardır.

İstek

Aşağıda bir locations.get isteği örneği verilmiştir:

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

İstek

Aşağıda bir locations.get yanıt örneği verilmiştir:

{
  "name": "locations/{locationId}",
  "title": "Test Business",
  "phoneNumbers": {
      "primaryPhone": "02 9374 4000"
   },
  ...
  "metadata": {
    "hasGoogleUpdated": true,
    ...
  }
  ...
}

Güncellenen alanları inceleyin

Google güncellemeleri içeren belirli alanları incelemek için locations.getGoogleUpdated yöntemini çağırın.

Bu yöntem, yanıt gövdesinde iki önemli maske döndürür:

  • diffMask: Yayınlanan verilerin (müşterilerin Google Haritalar ve Arama'da gördüğü veriler) yerel olarak tercih ettiğiniz değerlerden farklı olduğu alanları gösterir. Bu durum genellikle Google güncellemelerinden veya kullanıcı tarafından oluşturulan içeriklerden kaynaklanır. Tutarsızlığı gidermek için bu alanları kabul veya reddetmeniz gerekir.
  • pendingMask: Daha önce güncelleme gönderdiğiniz ancak güncellemenin hâlâ işlendiği ve henüz Google Haritalar ile Arama'ya aktarılmadığı alanları gösterir. Bu alanlarda işlem yapmanız gerekmez.

İstek

Aşağıda bir locations.getGoogleUpdated isteği örneği verilmiştir:

HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}:googleUpdated

Yanıt

Aşağıda bir locations.getGoogleUpdated yanıt örneği verilmiştir. phoneNumbers.primaryPhone alanında kullanılabilir bir güncelleme gösterilir. Bu yanıttaki değer, önerilen güncelleme değeridir:

{
  "location": {
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
  },
  "diffMask": "phoneNumbers.primaryPhone"
}

Güncellemeleri kabul etme veya reddetme

diffMask içinde listelenen alanları çözmek için bir locations.patch isteği kullanarak güncellemeleri kabul etmeniz veya reddetmeniz gerekir:

  • Güncellemeyi kabul etme: getGoogleUpdated yanıtında döndürülen yeni değeri kullanarak konumu yamalayın. Bu işlem, yerel kaydınızı yayınlama verileriyle eşleşecek şekilde günceller.
  • Güncellemeyi reddetme: Orijinal tercih ettiğiniz değeri kullanarak konumu yamalayın. Bu işlem, güncelleme ardışık düzeni aracılığıyla tercih ettiğiniz verileri yeniden onaylar ve yayınlama verilerinin üzerine yazar.

Her iki durumda da updateMask'i, çözmek istediğiniz alanları kapsayacak şekilde ayarlayın.

İstekleri kabul etme

Aşağıda bir locations.patch istek örneği verilmiştir:

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
}

Yanıt

Aşağıda bir locations.patch yanıt örneği verilmiştir:

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
}

İstekleri reddetme

Aşağıda bir locations.patch isteği örneği verilmiştir:

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

Yanıt

Aşağıda bir locations.patch yanıt örneği verilmiştir:

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

Sonuçları inceleme

Konumunuz başarıyla yamalanırsa locations.getGoogleUpdated yanıtındaki diffMask alanı, değerleri "diffMask": "" olarak gösterir. Ayrıca, Metadata içindeki "hasGoogleUpdated" işareti, değeri false olarak gösteriyor veya değer yok.

Alan değerleri net değilse getGoogleUpdated için istek ve yanıtla birlikte destek ekibimizle iletişime geçin. İstek, locations.patch çağrısından, yama çağrısından ve getGoogleUpdated çağrısından önceki yanıtı içermelidir.