הגדרות חיוב

הגדרת חיוב היא קישור ברמת החשבון בין חשבון 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

הערה: השדות payments_account ו-payments_account_info יאוכלסו בשליפות הבאות של הגדרת החיוב.

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

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

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

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