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

تتيح لك Google My Business API إنشاء مشاركات في بحث Google ضمن عدة فئات، مثل الأخبار والفعاليات والعروض.

يوضّح لك هذا الدليل التعليمي كيفية تنفيذ ما يلي:

قبل البدء

قبل استخدام Google My Business API، عليك تسجيل تطبيقك والحصول على بيانات اعتماد OAuth 2.0.

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

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

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

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

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

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