הגדרת חיוב

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

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

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

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

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

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

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

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

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

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

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

BillingSetup יכול להיות באחד מהמקומות הבאים ב-status:

סטטוס הגדרת החיוב תיאור
PENDING בהמתנה לאישור.
APPROVED_HELD אושר, אבל התקציב הראשון התואם לא אושר. מצב כזה יכול לקרות רק בהגדרות חיוב שהוגדרו לחיוב חודשי.
APPROVED ההגדרה אושרה.
CANCELLED ההגדרה בוטלה על ידי המשתמש לפני האישור.

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

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

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

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

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

הקודם
סקירה כללית
הבא
תקציב חשבון