הגדרות חיוב

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

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

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

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

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

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

כדי לקשר לחשבון תשלומים קיים, צריך להגדיר את payments_account לשם המשאב של חשבון תשלומים תקין (לדוגמה, customers/{customer_id}/paymentsAccounts/{payments_account_id}). עם זאת, אין לשנות את payments_account_info.

אפשר להציג רשימה של פרופילי תשלומים זמינים באמצעות ה-method‏ 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 Ads, הלקוח יירשם לחיוב באמצעות פרופיל התשלומים שאליו מתייחסים.

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

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

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

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

בדומה לרוב הישויות האחרות ב-Google Ads API, מקבלים BillingSetup על ידי שליחת שאילתה אל GoogleAdsService.Search או אל GoogleAdsService.SearchStream באמצעות שאילתת Google Ads Query Language ‏(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 להתחיל בעתיד.