توفّر لك واجهة برمجة تطبيقات "نشاطي التجاري على Google" إمكانية إنشاء مشاركات في "بحث Google" ضمن فئات متعددة، مثل الأخبار والفعاليات والعروض.
يوضّح لك هذا الدليل التوجيهي كيفية إجراء ما يلي:
- أنشِئ مشاركات الفعاليات.
- أنشِئ مشاركات الحث على اتّخاذ إجراء.
- أنشِئ مشاركات العروض.
- تعديل المشاركات.
- حذف المشاركات:
قبل البدء
قبل استخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google"، عليك تسجيل طلبك والحصول على بيانات اعتماد OAuth 2.0.
للحصول على تفاصيل حول كيفية بدء استخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google"، اطّلع على الإعداد الأساسي.
مشاركات الأحداث
أبلِغ عملائك بالفعالية التالية التي ستقام في نشاطك التجاري باستخدام مشاركة. تشتمل مشاركة الفعالية على تاريخَي البدء والانتهاء والوقت، ويتم عرضهما بشكلٍ بارز في المشاركة.
لإنشاء مشاركة في حساب مرتبط بمستخدم، يمكنك استخدام
accounts.locations.localPosts
API.
لإنشاء مشاركة لمستخدم تمت مصادقته، استخدِم ما يلي:
$ 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 الذي يقدّمه المستخدم
لإنشاء مشاركة مع زر الحث على اتخاذ إجراء، استخدم ما يلي:
$ 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 |
ينشئ مشاركة تطلب من المستخدم الاتصال بنشاط تجاري. |
مشاركات العروض
لإنشاء مشاركة عرض، استخدِم ما يلي:
$ 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
.
لتعديل مشاركة، استخدِم ما يلي:
$ PATCH https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary { "summary": "Order your Christmas turkeys now!!" }
حذف المشاركات
بعد إنشاء مشاركة، يمكنك حذفها من خلال طلب DELETE
.
لحذف مشاركة، استخدِم ما يلي:
$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}