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

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

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

يحدّد كل BillingSetup حساب دفعات يتم إصدار فواتير له مقابل التكاليف التي تتكبّدها ميزانيات حسابه. يرتبط حساب الدفع هذا بملف دفع يكون مسؤولاً في النهاية عن الرسوم.

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

• payments_account_info.payments_account_id: معرّف مكوّن من 16 رقمًا بتنسيق سلسلة مفصولة بشرطات (على سبيل المثال، "1234-5678-9012-3456") يُستخدَم لتحديد حساب الدفعات المرتبط بإعدادات الفوترة.
• استبدِل payments_account_info.payments_account_name بما يلي: اسم حساب الدفعات المرتبط بإعدادات الفوترة. يتم طباعة هذا الاسم على الفواتير الشهرية.
• payments_account_info.payments_profile_id: معرّف مكوّن من 12 رقمًا بتنسيق سلسلة مفصولة بشرطات (على سبيل المثال، "1234-5678-9012") يُستخدَم لتحديد ملف الدفع المرتبط بإعدادات الفوترة.

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

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

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

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

لربط حساب حالي على Payments، اضبط قيمة payments_account على اسم المورد الخاص بحساب دفعات صالح (مثلاً، customers/{customer_id}/paymentsAccounts/{payments_account_id}). ومع ذلك، لا تعدّل payments_account_info.

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

بالنسبة إلى كل PaymentsAccount، يظهر اسم المرجع الخاص بالحساب الإداري للدفع في الحقل paying_manager_customer.

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

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

• payments_account_name
• payments_profile_id

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

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

BillingSetupOperation operation =
    BillingSetupOperation.newBuilder().setCreate(billingSetup).build();

try (BillingSetupServiceClient billingSetupServiceClient =
    googleAdsClient.getBillingSetupServiceClient()) {
  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(
          Long.toString(customerId), operation);
}

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

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

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

يمكن أن يتضمّن BillingSetup إحدى القيم التالية status:

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

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

SELECT
  billing_setup.resource_name,
  billing_setup.id,
  billing_setup.status,
  billing_setup.payments_account,
  billing_setup.payments_account_info.payments_account_id,
  billing_setup.payments_account_info.payments_account_name,
  billing_setup.payments_account_info.payments_profile_id,
  billing_setup.payments_account_info.payments_profile_name,
  billing_setup.start_date_time,
  billing_setup.end_date_time,
  billing_setup.end_time_type
FROM billing_setup

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

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

يمكن إلغاء BillingSetup لم يصبح ساريًا بعد، وذلك عن طريق إرسال BillingSetupOperation مع ضبط الحقل remove على اسم المورد لإعداد الفوترة (customers/{customer_id}/billingSetups/{billing_setup_id}). لا يمكن إلغاء إعدادات الفوترة إلا إذا كانت حالة status هي PENDING أو إذا كانت APPROVED لبدء العمل في وقت ما في المستقبل.