إنشاء مشاركات على Google

توفّر لك واجهة برمجة تطبيقات "نشاطي التجاري على Google" إمكانية إنشاء مشاركات في "بحث Google" ضمن فئات متعددة، مثل الأخبار والفعاليات والعروض.

يوضّح لك هذا الدليل التوجيهي كيفية إجراء ما يلي:

قبل البدء

قبل استخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google"، عليك تسجيل طلبك والحصول على بيانات اعتماد OAuth 2.0.

للحصول على تفاصيل حول كيفية بدء استخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google"، اطّلع على الإعداد الأساسي.

مشاركات الأحداث

أبلِغ عملائك بالفعالية التالية التي ستقام في نشاطك التجاري باستخدام مشاركة. تشتمل مشاركة الفعالية على تاريخَي البدء والانتهاء والوقت، ويتم عرضهما بشكلٍ بارز في المشاركة.

لإنشاء مشاركة في حساب مرتبط بمستخدم، يمكنك استخدام accounts.locations.localPosts API.

لإنشاء مشاركة لمستخدم تمت مصادقته، استخدِم ما يلي:

بروتوكول 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"
}

مشاركات الحث على اتخاذ إجراء

تشتمل المشاركات التي تتضمن عبارة تحث المستخدم على اتخاذ إجراء على زر. يتم تحديد النص الموجود على زر الحث على اتخاذ إجراء من خلال الحقل actionType في المشاركة. تتم إضافة رابط إلى الزرّ يؤدي إلى عنوان URL الذي يقدّمه المستخدم

لإنشاء مشاركة مع زر الحث على اتخاذ إجراء، استخدم ما يلي:

بروتوكول 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"
}

أنواع الإجراءات

يمكن أن تحتوي مشاركات الحث على اتخاذ إجراء على أنواع إجراءات مختلفة تحدد نوع العبارة التي تحث المستخدم على اتخاذ إجراء.

في ما يلي الأنواع المتوافقة لعبارة الحث على اتخاذ إجراء:

أنواع الإجراءات
BOOK يتم إنشاء مشاركة تطلب من المستخدم حجز موعد أو طاولة أو شيء مشابه.
ORDER ينشئ مشاركة تطلب من المستخدم طلب شيء ما.
SHOP ينشئ مشاركة تطلب من المستخدم تصفّح كتالوج منتجات.
LEARN_MORE ينشئ مشاركة تطلب من المستخدم الاطّلاع على تفاصيل إضافية على موقع إلكتروني.
SIGN_UP ينشئ مشاركة تطلب من المستخدم التسجيل أو الاشتراك أو الانضمام إلى شيء ما.
CALL ينشئ مشاركة تطلب من المستخدم الاتصال بنشاط تجاري.

مشاركات العروض

لإنشاء مشاركة عرض، استخدِم ما يلي:

بروتوكول 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"
}

تعديل المشاركات

بعد إنشاء مشاركة، يمكنك تعديلها من خلال طلب PATCH.

لتعديل مشاركة، استخدِم ما يلي:

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

حذف المشاركات

بعد إنشاء مشاركة، يمكنك حذفها من خلال طلب DELETE.

لحذف مشاركة، استخدِم ما يلي:

بروتوكول HTTP
$ DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}