إعداد الفوترة

إعداد الفوترة هو رابط على مستوى الحساب بين حساب على "إعلانات Google" و"دفعات". الحساب (المعروف أيضًا باسم الفاتورة الإعداد)، والتي تساعدك يحدد من يتم إصدار فواتير التكاليف المتعلقة بحساب إعداد الفوترة الميزانيات. يتوافق كل حساب من حسابات الدفعات مع فاتورة واحدة.

لمحة عن حسابات الدفعات

تحدِّد كل BillingSetup حساب دفعات. يتم إصدار فواتير له عن التكاليف الناتجة عن ميزانيات الحساب هذه الدفعة مرتبطًا بحساب الدفعات الشخصي في النهاية مسئولون عن الرسوم.

تحتوي إعدادات الفوترة على كلٍّ من payments_account ومجموعة من payments_account_info الحقول التي تحدِّد حساب الدفعات المستخدَم، بما في ذلك ما يلي:

إذا كان حساب الدفعات مؤهَّلاً للدمج في حساب الدفعات الفوترة، ثم عدة خيارات يمكن تجميع حسابات "إعلانات Google" في الفاتورة نفسها من خلال ضبط إعدادات الفوترة الخاصة بها. استخدام حساب الدفعات الأساسي نفسه

إنشاء إعدادات فوترة جديدة

يمكنك ربط إعدادات الفوترة الجديدة بحسابات Payments الحالية أو الحسابات التي تم إنشاؤها. في نفس الوقت.

استخدام حساب دفعات حالي

للربط بحساب دفعات حالي، اضبط payments_account إلى معرّف مورد لحساب دفعات صالح. ومع ذلك، لا تعدِّل payments_account_info

يمكنك إدراج حسابات الدفعات المتاحة باستخدام PaymentsAccountService.ListPaymentsAccounts . تشير رسالة الأشكال البيانية تعتمد PaymentsAccounts التي تم إرجاعها على الحساب الإداري الذي تستخدمه من أجل المصادقة.

لكل PaymentsAccount، معرّف الدفع المدير في paying_manager_customer .

استخدام حساب دفعات جديد

للربط بحساب دفعات جديد، اضبط الحقول التالية في payments_account_info (لا تضبط payments_account):

يوضح المثال أدناه كيفية إنشاء إعداد فوترة جديد من حساب معرّف ملف الدفع كما هو موضح أعلاه، سيؤدي ذلك أيضًا إلى إنشاء مخطط جديد حساب دفعات بالاسم My New Payments Account

BillingSetup bsetup = BillingSetup.newBuilder()
    .setPaymentsAccountInfo(PaymentsAccountInfo.newBuilder()
        .setPaymentsAccountName("My New Payments Account")
        .setPaymentsProfileId("1234-5678-9012")
        .build())
    .setStartTimeType(TimeType.NOW)
    .build();

BillingSetupOperation op = BillingSetupOperation.newBuilder().setCreate(bsetup).build();

try (BillingSetupServiceClient billingSetupServiceClient = googleAdsClient
    .getBillingSetupServiceClient()) {

  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(Long.toString(customerId), op);
}

إذا كان هذا هو أول إعداد فوترة تتم إضافته إلى حساب على "إعلانات Google"، سيتم تسجيل اشتراك العميل في الفوترة باستخدام الدفعات المشار إليها بك.

حالة إعداد الفوترة

تخضع مثيلات BillingSetup الجديدة لـ والموافقة عليها قبل أن تدخل حيز التنفيذ. حتى ذلك الحين، status في PENDING الولاية.

يمكن أن يكون BillingSetup في أي مما يلي status:

حالة إعداد الفوترة الوصف
PENDING في انتظار الموافقة.
APPROVED_HELD تمت الموافقة على الطلب، ولكن لم تتم الموافقة على الميزانية الأولى المقابلة له. ولا يحدث ذلك إلا لإعدادات الفوترة التي تم ضبطها لنظام الفواتير الشهرية.
APPROVED تمت الموافقة على الإعداد.
CANCELLED ألغى المستخدم عملية الإعداد قبل الموافقة.

استرداد إعدادات الفوترة للحساب

كما هو الحال مع معظم الكيانات الأخرى في Google Ads API، تم استرجاع BillingSetup من خلال الاستعلام عن GoogleAdsService.SearchStream باستخدام طلب بحث بلغة طلب البحث في "إعلانات Google" يحدد الحقول المطلوب عرضها.

بعد الحصول على مرجع إلى BillingSetup، يمكنك استخدامه لإنشاء AccountBudgetProposal كما هو موضّح في ميزانية الحساب

إلغاء إعداد فوترة معلَّق

يمكن أن يكون الإجراء BillingSetup الذي لم يتم تطبيقه ساريًا بعد إلغاء باستخدام عملية الإزالة. لا يمكن إلغاء إعدادات الفوترة إلا في حال: status الخاصة بهم PENDING أو إذا كانت APPROVED للبدء في بعض الوقت في المستقبل.