تنبيه: يتم عرض مستندات واجهة REST API. تستخدم معظم مكتبات العملاء الرسمية خدمة gRPC. يمكنك الاطلاع على مقدمة عن REST للحصول على التفاصيل.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

CampaignBudget

تمثيل JSON
BudgetStatus
BudgetDeliveryMethod
BudgetPeriod
BudgetType

ميزانية الحملة.

تمثيل JSON

تمثيل JSON
{ "resourceName": string, "status": enum (`BudgetStatus`), "deliveryMethod": enum (`BudgetDeliveryMethod`), "period": enum (`BudgetPeriod`), "type": enum (`BudgetType`), "alignedBiddingStrategyId": string, "id": string, "name": string, "amountMicros": string, "totalAmountMicros": string, "explicitlyShared": boolean, "referenceCount": string, "hasRecommendedBudget": boolean, "recommendedBudgetAmountMicros": string, "recommendedBudgetEstimatedChangeWeeklyClicks": string, "recommendedBudgetEstimatedChangeWeeklyCostMicros": string, "recommendedBudgetEstimatedChangeWeeklyInteractions": string, "recommendedBudgetEstimatedChangeWeeklyViews": string }

{
  "resourceName": string,
  "status": enum (BudgetStatus),
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "type": enum (BudgetType),
  "alignedBiddingStrategyId": string,
  "id": string,
  "name": string,
  "amountMicros": string,
  "totalAmountMicros": string,
  "explicitlyShared": boolean,
  "referenceCount": string,
  "hasRecommendedBudget": boolean,
  "recommendedBudgetAmountMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyClicks": string,
  "recommendedBudgetEstimatedChangeWeeklyCostMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyInteractions": string,
  "recommendedBudgetEstimatedChangeWeeklyViews": string
}

الحقول
`resourceName`	`string` غير قابل للتغيير. اسم مورد ميزانية الحملة. تكون أسماء موارد ميزانية الحملة على النحو التالي: `customers/{customerId}/campaignBudgets/{campaign_budget_id}`
`status`	`enum (BudgetStatus)` النتائج فقط. حالة ميزانية الحملة هذه. هذا الحقل للقراءة فقط.
`deliveryMethod`	`enum (BudgetDeliveryMethod)` طريقة العرض التي تحدِّد معدّل إنفاق ميزانية الحملة. يتم ضبط السياسة تلقائيًا على STANDARD في حال عدم تحديدها في عملية إنشاء.
`period`	`enum (BudgetPeriod)` غير قابل للتغيير. الفترة التي سيتم إنفاق الميزانية خلالها. ويتم ضبط السياسة تلقائيًا على "يومي" إذا لم يتم تحديدها.
`type`	`enum (BudgetType)` غير قابل للتغيير. نوع ميزانية الحملة.
`alignedBiddingStrategyId`	`string (int64 format)` رقم تعريف استراتيجية المحفظة لعروض الأسعار التي تتوافق معها ميزانية الحملة المشتركة هذه. وعند توافق استراتيجية عروض الأسعار مع ميزانية الحملة، يتم إرفاقها بمجموعة الحملات نفسها. بعد مواءمة ميزانية الحملة مع استراتيجية عروض الأسعار، يجب أن تستخدم الحملات المُضافة إلى ميزانية الحملة استراتيجية عروض الأسعار المتوافقة أيضًا.
`id`	`string (int64 format)` النتائج فقط. رقم تعريف ميزانية الحملة. يتم إنشاء ميزانية حملة باستخدام عملية إنشاء CampaignBudgetService، ويتم تعيين رقم تعريف ميزانية لها. يمكن مشاركة رقم تعريف ميزانية بين حملات مختلفة، وسيوزّع النظام بعد ذلك ميزانية الحملة بين حملات مختلفة للحصول على أفضل النتائج.
`name`	`string` اسم ميزانية الحملة. عند إنشاء ميزانية حملة من خلال CampaignBudgetService، يجب أن يكون لكل ميزانية حملة مشتركة بشكل صريح اسم غير فارغ وغير فارغ. تستمد ميزانيات الحملات التي لم تتم مشاركتها بشكل صريح اسمها من اسم الحملة المرفقة. يجب أن يتراوح طول هذه السلسلة بين 1 و255، بشكل شامل، بترميز UTF-8 بايت، (قطع).
`amountMicros`	`string (int64 format)` مبلغ الميزانية بالعملة المحلية للحساب. ويتم تحديد المبلغ بالمايكرو، حيث يعادل المليون وحدة عملة واحدة. ويبلغ الحد الأقصى للإنفاق الشهري 30.4 ضِعف هذا المبلغ.
`totalAmountMicros`	`string (int64 format)` المبلغ الدائم للميزانية، بالعملة المحلية للحساب. ويتم تحديد المبلغ بالمايكرو، حيث يعادل المليون وحدة عملة واحدة.
`explicitlyShared`	`boolean` يُحدِّد ما إذا كانت الميزانية قد تمت مشاركتها بشكلٍ صريح أم لا. يتم ضبط هذه السياسة تلقائيًا على "صحيح" إذا لم يتم تحديدها في عملية إنشاء. في حال اختيار الإجابة "صحيح"، يتم إنشاء الميزانية بغرض مشاركتها على مستوى حملة واحدة أو أكثر. في حال اختيار القيمة "خطأ"، يتم إنشاء الميزانية بغرض استخدامها في حملة واحدة فقط. وسيظل اسم الميزانية وحالتها متزامنَين مع اسم الحملة وحالتها. ستؤدي محاولة مشاركة الميزانية مع حملة ثانية إلى حدوث خطأ. يمكن أن تصبح الميزانية غير المشتركة بمثابة ميزانية مشتركة بشكلٍ صريح. يجب أيضًا أن تحدد العملية نفسها اسمًا للميزانية. لا يجوز أبدًا أن تصبح ميزانية الحملة المشتركة غير مشتركة.
`referenceCount`	`string (int64 format)` النتائج فقط. عدد الحملات التي تستخدم الميزانية بفعالية. هذا الحقل للقراءة فقط.
`hasRecommendedBudget`	`boolean` النتائج فقط. يشير هذا العمود إلى ما إذا كانت هناك ميزانية مقترَحة لميزانية الحملة هذه. هذا الحقل للقراءة فقط.
`recommendedBudgetAmountMicros`	`string (int64 format)` النتائج فقط. مبلغ الميزانية المقترَح. وفي حال عدم توفّر أي اقتراح، سيتم ضبط هذا الإعداد على مبلغ الميزانية. ويتم تحديد المبلغ بالمايكرو، حيث يعادل المليون وحدة عملة واحدة. هذا الحقل للقراءة فقط.
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string (int64 format)` النتائج فقط. التغيير المقدَّر في النقرات الأسبوعية في حال تطبيق الميزانية المقترَحة. هذا الحقل للقراءة فقط.
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string (int64 format)` النتائج فقط. التغيير المقدَّر في التكلفة الأسبوعية بالمايكرو في حال تطبيق الميزانية المقترَحة. ويتساوى المليون مع وحدة عملة واحدة. هذا الحقل للقراءة فقط.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string (int64 format)` النتائج فقط. التغيير المقدَّر في التفاعلات الأسبوعية في حال تطبيق الميزانية المقترَحة. هذا الحقل للقراءة فقط.
`recommendedBudgetEstimatedChangeWeeklyViews`	`string (int64 format)` النتائج فقط. التغيير المقدَّر في المشاهدات الأسبوعية في حال تطبيق الميزانية المقترَحة. هذا الحقل للقراءة فقط.

BudgetStatus

الحالات المحتملة للميزانية.

عمليات التعداد
`UNSPECIFIED`	عدم تحديد صيغة مخاطبة
`UNKNOWN`	تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
`ENABLED`	تم تفعيل الميزانية.
`REMOVED`	تمت إزالة الميزانية.

BudgetDeliveryMethod

طرق التسليم الممكنة للميزانية.

عمليات التعداد
`UNSPECIFIED`	عدم تحديد صيغة مخاطبة
`UNKNOWN`	تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
`STANDARD`	سيحدّد خادم الميزانية عرض الإعلانات بشكل متساوٍ خلال الفترة الزمنية بالكامل.
`ACCELERATED`	ولن يحدّ خادم الميزانية من عرض الإعلانات، وسيتم عرض الإعلانات في أسرع وقت ممكن.

BudgetPeriod

الفترة المحتملة للميزانية.

عمليات التعداد
`UNSPECIFIED`	عدم تحديد صيغة مخاطبة
`UNKNOWN`	تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
`DAILY`	الميزانية اليومية.
`CUSTOM_PERIOD`	تمت إضافة ميزانية مخصّصة مرة أخرى في الإصدار 5. يمكن استخدام ميزانية مخصّصة مع total_amount لتحديد حد الميزانية الدائمة. يمكنك الانتقال إلى https://support.google.com/google-ads/answer/6385083 للاطّلاع على مزيد من المعلومات.

BudgetType

أنواع الميزانيات المحتملة.

عمليات التعداد
`UNSPECIFIED`	عدم تحديد صيغة مخاطبة
`UNKNOWN`	تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
`STANDARD`	نوع الميزانية للاستخدام العادي في "إعلانات Google". يضع حدًّا أقصى للإنفاق اليومي بمقدار ضِعف مبلغ الميزانية المحدّد. التفاصيل الكاملة: https://support.google.com/google-ads/answer/6385083
`FIXED_CPA`	نوع ميزانية مع تكلفة إجراء ثابتة (إحالة ناجحة) التفاصيل الكاملة: https://support.google.com/google-ads/answer/7528254 لا يتوافق هذا النوع إلا مع الحملات التي تحتوي على AdvertisingChannelType.DISPLAY (باستثناء AdvertisingChannelSubType.DISPLAY_USERNAME) وBidStrategyType.TARGET_CPA وPaymentMode.أريد.
`SMART_CAMPAIGN`	نوع ميزانية الحملة الذكية. التفاصيل الكاملة: https://support.google.com/google-ads/answer/7653509 لا يتوافق هذا النوع إلا مع الحملات التي تتضمّن AdvertisingChannelType.SMART و AdvertisingChannelSubType.SMART_CAMPAIGN.
`LOCAL_SERVICES`	نوع الميزانية لحملة "الخدمات المحلّية". التفاصيل الكاملة: https://support.google.com/localservices/answer/7434558 لا يتوافق هذا النوع إلا مع الحملات التي تحتوي على AdvertisingChannelType.LOCAL_SERVICES.