Google'da yayın oluşturma

Google Benim İşletmem API'si, Google Arama'da haber, etkinlik ve teklif gibi çeşitli kategorilerde yayın oluşturmanıza olanak tanır.

Bu eğitimde aşağıdakilerin nasıl yapılacağı gösterilmektedir:

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 bölümüne bakın.

Etkinlik yayınları

İşletmenizdeki bir sonraki etkinlik hakkında müşterilerinize bir yayın göndererek bilgi verin. Etkinliklerinizle ilgili gönderilerinizde başlangıç ve bitiş tarihleri ile saatleri görebilirsiniz.

Kullanıcıyla ilişkili bir hesapta yayın oluşturmak için accounts.locations.localPosts API'sini kullanın.

Kimliği doğrulanmış bir kullanıcı için gönderi oluşturmak üzere aşağıdakileri kullanın:

HTTP
$ 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 gönderilerde bir düğme bulunur. Harekete geçirici mesaj düğmesindeki metin, yayının actionType alanına göre belirlenir. Düğmeye, kullanıcı tarafından sağlanan bir 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:

HTTP
$ 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 mesaj yayınları, harekete geçirici mesaj yayınının türünü belirleyen farklı işlem türlerine sahip olabilir.

Aşağıdaki harekete geçirici mesaj türleri desteklenir:

İşlem türleri
BOOK Kullanıcıdan randevu, masa veya benzer bir şey rezerve etmesini isteyen bir Gönderi oluşturur.
ORDER Kullanıcıdan bir şey sipariş etmesini isteyen bir yayın oluşturur.
SHOP Kullanıcıdan bir ürün kataloğuna göz atmasını isteyen bir yayın oluşturur.
LEARN_MORE Kullanıcıyı bir web sitesinde ek ayrıntıları görmeye teşvik eden bir Yayın oluşturur.
SIGN_UP Kullanıcıdan kaydolmasını, kaydolma işlemini tamamlamasını veya bir şeye katılmasını isteyen bir yayın oluşturur.
CALL Kullanıcının bir işletmeyi aramasını isteyen bir yayın oluşturur.

Tekliflerle ilgili yayınlar

Teklif gönderisi oluşturmak için aşağıdakileri kullanın:

HTTP
$ 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üzenleme

Oluşturulan bir gönderiyi PATCH isteğiyle düzenleyebilirsiniz.

Bir yayını düzenlemek için aşağıdakileri kullanın:

HTTP
$ PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary
{
  "summary": "Order your Christmas turkeys now!!"
}

Yayınları silme

Oluşturulan bir yayını DELETE isteğiyle silebilirsiniz.

Bir yayını silmek için aşağıdakileri kullanın:

HTTP
$ DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}