Google Benim İşletmem API'si size Google Arama'da haberler, etkinlikler ve teklifler gibi çeşitli kategorilerde Yayın oluşturmanıza olanak tanır.
Bu eğitimde, aşağıdakilerin nasıl yapılacağı gösterilmektedir:
- Etkinlik Yayınları oluşturun.
- Harekete geçirici mesaj gönderileri oluşturun.
- Teklif Yayınları oluşturun.
- Yayınları düzenleme
- Yayınları silin.
Başlamadan önce
Google Benim İşletmem API'sini kullanmadan önce uygulamanızı kaydettirmeniz ve OAuth 2.0 kimlik bilgilerini almanız gerekir.
Google Benim İşletmem API'sini kullanmaya başlama hakkında ayrıntılı bilgi için Temel kurulum başlıklı makaleyi inceleyin.
Etkinlik Yayınları
Yayınlayarak müşterilerinizi işletmenizde bir sonraki etkinlik hakkında bilgilendirin. Bir etkinlik için paylaştığınız Yayın, Yayında belirgin şekilde gösterilen başlangıç ve bitiş tarihleri ve saatleri içerir.
Bir kullanıcıyla ilişkili hesaba gönderi oluşturmak için accounts.locations.localPosts
API'yi kullanın.
Kimliği doğrulanmış bir kullanıcı için yayın oluşturmak üzere aşağıdakileri kullanın:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Come in for our spooky Halloween event!", "event": { "title": "Halloween Spook-tacular!", "schedule": { "startDate": { "year": 2017, "month": 10, "day": 31, }, "startTime": { "hours": 9, "minutes": 0, "seconds": 0, "nanos": 0, }, "endDate": { "year": 2017, "month": 10, "day": 31, }, "endTime": { "hours": 17, "minutes": 0, "seconds": 0, "nanos": 0, }, } }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-image.jpg", } ], "topicType": "EVENT" }
Harekete geçirici mesaj gönderileri
Harekete geçirici mesaj içeren yayınlar bir düğme içerir. Harekete geçirici mesaj düğmesinin metni, Yayının actionType
alanı tarafından belirlenir. Düğmeye, kullanıcı tarafından sağlanan URL'nin bağlantısı eklenir.
Harekete geçirici mesaj düğmesi içeren bir yayın oluşturmak için aşağıdakileri kullanın:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Order your Thanksgiving turkeys now!!", "callToAction": { "actionType": "ORDER", "url": "http://google.com/order_turkeys_here", }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-turkey-photo.jpg", } ], "topicType": "OFFER" }
İşlem türleri
Harekete geçirici mesajlar "Gönderiler"in, harekete geçirici mesaj türünü belirleyen farklı işlem türleri olabilir.
Desteklenen harekete geçirici mesaj türleri şunlardır:
İşlem türleri | |
---|---|
BOOK |
Kullanıcıdan randevu veya masa ya da benzer bir şey rezerve etmesini isteyen bir Yayın oluşturur. |
ORDER |
Kullanıcının sipariş vermesini isteyen bir yayın oluşturur. |
SHOP |
Kullanıcıdan ürün kataloğuna göz atmasını isteyen bir Yayın oluşturur. |
LEARN_MORE |
Kullanıcının web sitesindeki ek ayrıntıları görmesini isteyen bir Yayın oluşturur. |
SIGN_UP |
Kullanıcının bir şeye kaydolmasını, kaydolmasını veya bir şeye katılmasını isteyen Yayın oluşturur. |
CALL |
Kullanıcının bir işletmeyi aramasını isteyen Yayın oluşturur. |
Teklif Yayınları
Teklif Yayını oluşturmak için şunları kullanın:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Buy one Google jetpack, get a second one free!!", "offer": { "couponCode": “BOGO-JET-CODE”, "redeemOnlineUrl": “https://www.google.com/redeem”, "termsConditions": “Offer only valid if you can prove you are a time traveler” }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-jetpack-photo.jpg", } ], "topicType": "OFFER" }
Yayınları Düzenle
Oluşturulan bir yayını PATCH
isteğiyle düzenleyebilirsiniz.
Bir yayını düzenlemek için şunları kullanın:
$ PATCH https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary { "summary": "Order your Christmas turkeys now!!" }
Yayınları Sil
Oluşturulan bir yayını DELETE
isteğiyle silebilirsiniz.
Bir yayını silmek için şunları kullanın:
$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}