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

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

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

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

تنظیمات صورتحساب شامل فیلد payments_account و گروهی از فیلدهای payments_account_info است که حساب 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);
}

اگر این اولین تنظیمات صورتحسابی است که به حساب گوگل ادز اضافه می‌شود، این کار عملاً مشتری را برای صورتحساب با استفاده از نمایه پرداخت‌های ارجاع‌شده ثبت‌نام می‌کند.

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

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

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

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

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

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

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

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

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

قبلی
نمای کلی صورتحساب
بعدی
بودجه حساب