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

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

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

قبل البدء

قبل استخدام واجهة برمجة التطبيقات لبرنامج "نشاطي التجاري على Google"، عليك تسجيل تطبيقك والحصول على بيانات اعتماد 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}