Google'da yayın oluşturma

Google Benim İşletmem API'si, Google Arama'da haberler, etkinlikler ve teklifler gibi çeşitli kategorilerde yayınlar 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ı kaydetmeniz ve OAuth 2.0 kimlik bilgilerini almanız gerekir.

Google Benim İşletmem API'yi kullanmaya başlama hakkında ayrıntılı bilgi için Temel kurulum başlıklı makaleyi inceleyin.

Etkinliklerle İlgili Yayınlar

Yayın ile müşterilerinizi işletmenizdeki bir sonraki etkinlik hakkında bilgilendirin. Etkinlik gönderinizde başlangıç ve bitiş tarihleri ile saatleri yer alır. Bu bilgiler, gönderide belirgin bir şekilde gösterilir.

Bir kullanıcıyla ilişkili bir hesapta gönderi 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 yayınlarda bir düğme bulunur. Harekete geçirici mesaj düğmesindeki metin, gönderinin 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.

Desteklenen harekete geçirici mesaj türleri şunlardır:

İşlem türleri
BOOK Kullanıcıyı randevu, masa veya benzeri bir şey ayırtmaya yönlendiren bir gönderi oluşturur.
ORDER Kullanıcıyı bir şey sipariş etmeye yönlendiren bir yayın oluşturur.
SHOP Kullanıcıyı ürün kataloğuna göz atmaya yönlendiren bir gönderi oluşturur.
LEARN_MORE Kullanıcıyı bir web sitesinde ek ayrıntıları görmeye yönlendiren bir gönderi oluşturur.
SIGN_UP Kullanıcıyı kaydolmaya, bir şeye katılmaya veya abone olmaya yönlendiren bir yayın oluşturur.
CALL Kullanıcıyı bir işletmeyi aramaya yönlendiren bir yayın oluşturur.

Fırsat yayınları

Fırsat 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": "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

Bir gönderi oluşturulduktan sonra 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

Bir gönderi oluşturulduktan sonra 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}