FACEBOOK وINSTAGRAM.
تستدعي كل عملية نقطة نهاية الإعلانات المقابلة في REST وتُرجع استجابتها دون تغيير. المصادقة والحدود مطابقة لـ REST. يُرجع الاستدعاء الفاشل خطأ GraphQL: يحمل extensions.status حالة REST، ويحمل extensions.code رمز خطأ Ayrshare عندما يتضمن خطأ REST رمزًا. راجع الأخطاء. تتطلب عمليات الإعلانات وظيفة Ads الإضافية. وبدونها، يُرجع كل استدعاء خطأً بقيمة 403 في extensions.status وقيمة 399 في extensions.code.
العمليات
تأخذ كل عملية أيضًا وسيط
profileKey اختياريًا للعمل على User Profile (ملف المستخدم الشخصي). وتُرجع جميعها استجابة REST بصيغة JSON، لذا لا تقبل تحديد الحقول.
سرد الحسابات الإعلانية
ابدأ من هنا. استخدم قيمaccountId الواردة في الاستجابة حيثما تطلب عملية ما accountId.
البحث في خيارات الاستهداف
يحددkind نوع البحث: INTERESTS لاستهداف الجمهور، وREGIONS أو CITIES للمواقع. يأخذ كل نوع وسائطه الخاصة فقط. على سبيل المثال، لا يعمل countryCode وregionId إلا مع CITIES، ويتطلب INTERESTS الوسيط search.
سرد الإعلانات
مرّر واحدًا على الأقل منcampaignId أو accountId أو adId أو postId أو socialPostId. يمثّل socialPostId معرّف المنشور الخاص بالشبكة نفسها، للمنشورات التي لم تُنشر عبر Ayrshare.
معرفة تكلفة إعلان
إيقاف إعلان مؤقتًا أو استئنافه
يُغيّرupdateAd الإنفاق الإعلاني الفعلي. توقف PAUSED الإنفاق، وتستأنفه ACTIVE، وتُنهي DELETED أو ARCHIVED الإعلان. تُطبَّق الحالة نفسها أيضًا على مجموعة الإعلان والحملة التابعين للإعلان، لذا تتغير معها أي إعلانات أخرى في مجموعة الإعلان أو الحملة تلك.
لا تزال العمليات الخاصة بكل منصة، مثل
facebookAdAccounts وinstagramAds، تعمل دون تغيير.