إنشاء مشاركات على 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}