تنظیم صورتحساب

تنظیم صورت‌حساب پیوندی در سطح حساب بین حساب Google Ads و حساب پرداخت‌ها (همچنین به عنوان تنظیم فاکتور شناخته می‌شود) است که به طور مؤثر تعیین می‌کند چه کسی برای هزینه‌های متحمل شده توسط بودجه حساب راه‌اندازی صورت‌حساب صورت‌حساب می‌شود. هر حساب Payments مربوط به یک فاکتور است.

درباره حساب های پرداخت

هر BillingSetup یک حساب Payments را شناسایی می کند که برای هزینه های متحمل شده توسط بودجه حساب خود صورتحساب دریافت می کند. این حساب Payments با نمایه Payments مرتبط است که در نهایت مسئول هزینه‌ها است.

تنظیمات صورت‌حساب شامل یک قسمت payments_account و گروهی از فیلدهای payments_account_info هستند که مشخص می‌کنند حساب Payments در حال استفاده است، از جمله موارد زیر:

اگر یک حساب Payments برای صورت‌حساب تلفیقی واجد شرایط باشد، می‌توان چندین حساب Google Ads را در یک فاکتور با تنظیم تنظیمات صورت‌حسابشان برای استفاده از یک حساب Payments اساسی گروه‌بندی کرد.

ایجاد تنظیمات صورتحساب جدید

می‌توانید تنظیمات صورت‌حساب جدید را به حساب‌های Payments موجود یا حساب‌هایی که همزمان ایجاد شده‌اند پیوند دهید.

با استفاده از یک حساب پرداخت موجود

برای پیوند با یک حساب Payments موجود ، payments_account را روی شناسه منبع یک حساب Payments معتبر تنظیم کنید. با این حال، payments_account_info را تغییر ندهید .

می‌توانید حساب‌های پرداخت موجود را با روش PaymentsAccountService.ListPaymentsAccounts فهرست کنید. PaymentsAccounts برگردانده شده به حساب مدیری که برای احراز هویت استفاده می کنید بستگی دارد.

برای هر PaymentsAccount ، شناسه مدیر پرداخت آن در قسمت paying_manager_customer است.

استفاده از حساب پرداخت جدید

برای پیوند با یک حساب Payments جدید، فیلدهای زیر را در payments_account_info تنظیم کنید ( payments_account را تنظیم نکنید ):

مثال زیر نحوه ایجاد یک تنظیم صورت‌حساب جدید از شناسه نمایه Payments موجود را نشان می‌دهد. همانطور که در بالا نشان داده شد، با این کار یک حساب پرداخت جدید با نام 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 Ads اضافه می‌شود، با استفاده از نمایه Payments ارجاع شده، مشتری را برای صدور صورت‌حساب ثبت‌نام می‌کند.

وضعیت تنظیم صورت‌حساب

موارد جدید BillingSetup قبل از اجرایی شدن منوط به تأیید هستند. تا آن زمان، status آنها در وضعیت PENDING است.

BillingSetup می تواند در یکی از status زیر باشد:

وضعیت تنظیم صورت‌حساب شرح
PENDING در انتظار تایید.
APPROVED_HELD تصویب شده اما بودجه اول مربوطه تایید نشده است. این فقط برای تنظیمات صورت‌حساب پیکربندی شده برای صورت‌حساب ماهانه ممکن است رخ دهد.
APPROVED راه اندازی تایید شد.
CANCELLED تنظیم قبل از تأیید توسط کاربر لغو شد.

بازیابی تنظیم صورت‌حساب حساب

مانند بسیاری از موجودیت‌های دیگر در Google Ads API، BillingSetup با جستجو در GoogleAdsService.SearchStream با استفاده از عبارت جستجوی زبان جستجوی Google Ads که مشخص می‌کند کدام فیلدها را بازگرداند، واکشی می‌شود.

هنگامی که یک مرجع به BillingSetup دریافت کردید، می توانید از آن برای ایجاد یک AccountBudgetProposal همانطور که در بودجه حساب توضیح داده شده است استفاده کنید.

در حال لغو تنظیم صورت‌حساب معلق

BillingSetup که هنوز اعمال نشده است را می توان با استفاده از عملیات حذف لغو کرد. تنظیمات صورت‌حساب را فقط در صورتی می‌توان لغو کرد که status آن‌ها PENDING باشد یا اگر برای شروع مدتی در آینده APPROVED باشد.