İşletme Profili'nden ilk katılım konumları

İşletme Profili, işletmelerin ve kuruluşların Arama ve Haritalar dahil olmak üzere Google genelinde internetteki kimliklerini yönetmelerini sağlayan ücretsiz ve kullanımı kolay bir araçtır.

Google İşletme Profili API'si, Google'daki işletme konumu bilgilerini yönetmek için bir arayüz sağlar. Bir işletme, profilini o işletme adına yönetmek için OAuth izni aracılığıyla başka bir işletmeye erişim verebilir.

İşletme Profili'nde yönetilen işletmeler, İşletme Profili doğrulama süreciyle zaten doğrulanmıştır. İşletme Profili OAuth izin akışını genişleterek bu işletmeleri Business Messages'a dahil edebilir ve Business Messages'ta kullanıma sunulmalarını otomatik olarak doğrulayabilirsiniz.

Bu, İşletme Mesajlarını başlatmak için daha ölçeklenebilir ve hızlı bir yöntemdir ve İşletme Profilindeki konum için mesajlaşmayı etkinleştirmek üzere önerilen akıştır.

Ön koşullar

Google İşletme Profili API'lerine erişimi olan mevcut bir İşletme Profili iş ortağı olmanız gerekir. Aksi takdirde, erişim başvurusunda bulunmak için İşletme Profili ön koşullarını uygulayın.

Google Business Profile API'ye erişim izni aldıktan sonra, devam etmeden önce temel kurulum ve OAuth kurulumu rehberlerini inceleyin.

Doğrulanmış bir İşletme Profili konumu için Business Messages'ı etkinleştirme

Aşağıdaki şemada web hizmetinizin bir Business Messages temsilcisi için markanın İşletme Profili konum doğrulamasından nasıl yararlanabileceği gösterilmektedir. Ayrıntılı talimatlara bakın.

İşletme Profili doğrulamasını kullanarak temsilcileri otomatik olarak doğrulama ile ilgili akış şeması

  1. İşletme Profili hesabı sahibinin size kendi adına Google İşletme Profili API'lerini çağırmak için erişim verdiği mevcut OAuth izin akışınızda API kapsamlarını şunları içerecek şekilde güncelleyin:

    • https://www.googleapis.com/auth/business.manage
    • https://www.googleapis.com/auth/businesscommunications

    Temsilcinin ve işletmenin bulunduğu konumların başarıyla otomatik olarak doğrulanması için her iki kapsam da gereklidir.

  2. Önceki adımda elde ettiğiniz OAuth kimlik bilgilerine ait Google İşletme Profili girişlerinden en az birinin adıyla eşleşen, displayName ile bir aracı oluşturun. İşletmelerin adlarını bulmak için konumları Google İşletme Profili API'siyle arayın.

    Ad eşleşmesi için

    • Karakter büyük/küçük harfe duyarlı değildir.
    • Temsilcinin tam adı, İşletme Profili yer adındaki ilk kelime veya kelimelerle tam olarak eşleşmelidir. Örneğin, "GBP Pastacılık" adlı bir temsilci "Gbp Fırın Mountain View", "Gbp Bakery" ve "gbp bakery sunvale" ile eşleşir ancak "Bakery San Francisco" ile eşleşmez.

  3. İşletme Profili'ndeki her konum için aynı placeId ile bir konum oluşturun. İşletme Profili konumu için placeId, Google İşletme Profili API'sinden bir konum alındığında LocationKey nesnesinin içinde yer alır.

  4. Oluşturduğunuz temsilci ve elde edilen OAuth jetonu ile aracı doğrulaması isteyin.

    Doğrulama isteği için marka iletişim bilgileri gerekiyor. Ancak temsilci adı İşletme Profili adıyla eşleşiyorsa ve OAuth jetonunu doğru kapsamlarla edindiyseniz doğrulama işlemi markaya e-posta göndermez.

    Bu işlemi doğru bir şekilde yaptıysanız doğrulama isteği sonucundan hemen verificationState tutarında bir VERIFICATION_STATE_VERIFIED döndürülür. verificationState farklı bir değer döndürürse istekte bulunurken doğru OAuth jetonunu kullanmadığınız veya temsilcinin bir İşletme Profili konumuyla eşlenemediği durumlar olabilir.

  5. Aynı OAuth jetonunu kullanarak işletmenin İşletme Profilindeki tüm konumların konum doğrulamasını isteyin.

    Aracı doğrulamasında olduğu gibi, bunu doğru bir şekilde yaptıysanız doğrulama isteği sonucundan gelen sonuç hemen verificationState tutarında bir VERIFICATION_STATE_VERIFIED döndürmelidir. verificationState farklı bir değer döndürürse istekte bulunurken doğru OAuth jetonunu kullanmamış olabilirsiniz. Bunun yerine, İşletme Profili konumu için hak talebinde bulunulmuş ve doğrulanmış bir işletme olmayabilir.

  6. LOCATION giriş noktasıyla aracıyı başlatın.

  7. Arama ve Haritalar üzerinden kullanılmasını istediğiniz konumları başlatarak belirli konumlar için mesajlaşmayı etkinleştirin. Başlatma süreci başladığında, başlatılmış her bir konum için mesajlaşma özelliği birkaç saat içinde kullanıcılara sunulacak.

Bu adımları uyguladıktan sonra tüm tüketici mesajları, kayıtlı Business Messages webhook'unuzda yayınlanır ve tüketicilere Business Messages API ile yanıt göndermeniz gerekir.