Google'da yayın oluşturma

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:

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:

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 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:

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 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:

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üzenle

Oluşturulan bir yayını PATCH isteğiyle düzenleyebilirsiniz.

Bir yayını düzenlemek için şunları 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ı Sil

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

Bir yayını silmek için şunları kullanın:

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