הגדרת חיוב

הגדרת חיוב היא קישור ברמת החשבון בין חשבון Google Ads לחשבון תשלומים (שנקרא גם הגדרת חשבונית), שמאפשר לקבוע מי יתחייב על העלויות שנצברו בתקציבי החשבון של הגדרת החיוב. כל חשבון תשלומים תואם לחשבונית אחת.

מידע על חשבונות תשלומים

כל BillingSetup מזהה חשבון תשלומים שמחויב על העלויות שנצברו בתקציבי החשבון שלו. חשבון התשלומים הזה משויך לפרופיל תשלומים שהוא האחראי הסופי על החיובים.

הגדרות החיוב מכילות גם את השדה payments_account וגם קבוצה של שדות payments_account_info שמזהים את חשבון התשלומים שבשימוש, כולל:

• payments_account_info.payments_account_id: מזהה בן 16 ספרות שמזהה את חשבון התשלומים שמשויך להגדרת החיוב.
• payments_account_info.payments_account_name: השם של חשבון התשלומים שמשויך להגדרת החיוב. השם הזה מודפס בחשבוניות החודשיות.
• payments_account_info.payments_profile_id: מזהה בן 12 ספרות שמזהה את פרופיל התשלומים שמשויך להגדרת החיוב.

אם חשבון Payments עומד בדרישות לחיוב מאוחד, אפשר לקבץ כמה חשבונות Google Ads באותה חשבונית על ידי הגדרת הגדרות החיוב שלהם כך שישתמשו באותו חשבון Payments בסיסי.

יצירת הגדרות חיוב חדשות

אפשר לקשר הגדרות חיוב חדשות לחשבונות תשלומים קיימים או לחשבונות שיצרתם באותו זמן.

שימוש בחשבון תשלומים קיים

כדי לקשר לחשבון תשלומים קיים, צריך להגדיר את payments_account למזהה המשאב של חשבון תשלומים תקין. עם זאת, אין לשנות את payments_account_info.

אפשר לקבל רשימה של חשבונות התשלום הזמינים באמצעות השיטה PaymentsAccountService.ListPaymentsAccounts. הערך של PaymentsAccounts שמוחזר תלוי בחשבון הניהול שבו אתם משתמשים לאימות.

לכל PaymentsAccount, המזהה של המנהל המשלם מופיע בשדה paying_manager_customer.

שימוש בחשבון תשלומים חדש

כדי לקשר לחשבון תשלומים חדש, מגדירים את השדות הבאים ב-payments_account_info (לא מגדירים את payments_account):

• payments_account_name
• payments_profile_id

בדוגמה הבאה מוסבר איך יוצרים הגדרת חיוב חדשה ממזהה פרופיל תשלומים קיים. כפי שצוין למעלה, הפעולה הזו תיצור גם חשבון תשלומים חדש בשם 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, הלקוח יירשם לחיוב באמצעות פרופיל התשלומים שצוין.

סטטוס הגדרת החיוב

מכונות BillingSetup חדשות צריכות לעבור אישור לפני שהן נכנסות לתוקף. עד אז, הערך של status יהיה PENDING.

הערך של BillingSetup יכול להיות אחד מהערכים הבאים של status:

אחזור של הגדרת החיוב בחשבון

בדומה לרוב הישות האחרות ב-Google Ads API, כדי לאחזר BillingSetup שולחים שאילתה אל GoogleAdsService.SearchStream באמצעות שאילתת Google Ads Query Language שמציינת את השדות שרוצים להחזיר.

אחרי שמקבלים הפניה ל-BillingSetup, אפשר להשתמש בה כדי ליצור AccountBudgetProposal כפי שמתואר בקטע תקציב חשבון.

ביטול של הגדרת חיוב בהמתנה

אפשר לבטל BillingSetup שעדיין לא נכנס לתוקף באמצעות פעולת ההסרה. אפשר לבטל הגדרות חיוב רק אם status שלהן PENDING או אם הן APPROVED אמורות להתחיל מתישהו בעתיד.