ייצוא נתונים של שירותים בערוצים ל-BigQuery

בדף הזה מוסבר איך להגדיר ייצוא של שירותי ערוצים, וגם מתוארת הסכימה הזמינה לייצוא.

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

ייצואים משירותי ערוצים מכילים נתונים ספציפיים למפיצים שלא נכללים בייצואים של חיוב ב-Cloud. הנתונים כוללים עלויות, קרדיטים ונתוני שימוש עם כללי התמחור מחדש שהגדרתם. בנוסף, הייצוא הזה כולל צבירה של כל המידע על חשבונות ההורה לחיוב של הלקוחות שלכם במערך נתונים יחיד.

עם זאת, הנתונים מייצוא של שירותים בערוצים שונים תואמים לייצוא של נתוני חיוב ב-Cloud, ואפשר להשתמש בשאילתות כדי לצרף את שני מערכי הנתונים לצורך ניתוח.

מידע על ייצוא נתוני חיוב ב-Cloud שלא דרך משווק זמין במאמר בנושא הגדרת ייצוא של נתוני חיוב ב-Cloud ל-BigQuery.

לפני שמתחילים

לפני שמתחילים לייצא נתוני חיוב על שירותים בערוצים שונים, צריך:

  • מגדירים פרויקט לאירוח של מערך הנתונים ב-BigQuery. מוודאים שהחיוב מופעל בפרויקט.
  • מפעילים את שירות העברת נתונים ל-BigQuery API בפרויקט.
  • יוצרים מערך נתונים לנתונים המיוצאים.

אם כבר יש לכם פרויקט ומערך נתונים ב-BigQuery לייצוא של נתוני חיוב ב-Cloud, אתם יכולים להשתמש בהם גם לייצוא של נתוני חיוב על שירותים בערוצים שונים.

מידע מפורט על הגדרת פרויקט ומערך נתונים זמין במאמר בנושא הגדרת הייצוא של נתוני החיוב ב-Cloud ל-BigQuery.

ההרשאות שנדרשות לייצוא

כדי להפעיל ולהגדיר את הייצוא של שירותי ערוצים, צריך את התפקידים הבאים:

בחירת פרויקט ומערך נתונים

במסוף המכירות של תוכנית המכירות של שותפי YouTube, בוחרים פרויקט ומערך נתונים ב-BigQuery לאחסון נתוני שירותי הערוצים. מפעילים את החיוב בפרויקט, אם הוא עדיין לא מופעל.

כשבוחרים או יוצרים מערך נתונים של BigQuery, אפשר לבחור אחד מהמיקומים הנתמכים של BigQuery למערך הנתונים. כשמפעילים את ייצוא הנתונים של שירותים בערוצים בפעם הראשונה לכל מקור נתונים (Google Cloud או Google Workspace):

  • אם מגדירים שמערך הנתונים ב-BigQuery יתבסס על מיקום במספר אזורים, נתוני הייצוא ל-BigQuery יהיו זמינים לכל מקור נתונים שנבחר מתחילת החודש הקודם. לדוגמה, אם תפעילו את BigQuery Export ב-23 בספטמבר, הייצוא יכלול נתונים שנצברו החל מ-1 באוגוסט.

  • אם מגדירים שמערך הנתונים ב-BigQuery יתבסס על מיקום באזור (שלא בארה"ב או באיחוד האירופי), נתוני הייצוא ל-BigQuery יהיו זמינים לכל מקור נתונים שנבחר החל מהתאריך שבו הפעלתם את הייצוא. כלומר, נתוני BigQuery Export לא יתווספו רטרואקטיבית למערכי נתונים שהמיקום שלהם הוא לא במספר אזורים, כך שלא תראו את נתוני BigQuery Export שצברתם לפני שהפעלתם את הייצוא.

כדי לייצא נתוני חיוב של כמה חשבונות ב-Partner Sales Console, פועלים לפי השלבים הבאים:

  1. במערך הנתונים ב-BigQuery שאליו רוצים לייצא את הנתונים, מוודאים שלמנהלי החיוב בכל חשבון ב-Partner Sales Console יש הרשאות לצפייה במערך הנתונים.
  2. כשמגדירים את ייצוא נתוני החיוב בכל חשבון Partner Sales Console, צריך לבחור את מערך הנתונים המאוחד.

מיקומים נתמכים ב-BigQuery

יש שני סוגים של אזורים ש-BigQuery תומך בהם.

במספר אזורים

בטבלה הבאה מפורטים האזורים שבהם נתמך ייצוא נתונים של Channel Services ל-BigQuery.

תיאור של המיקום 'במספר אזורים' השם של המיקום 'במספר אזורים'
מרכזי נתונים במדינות החברות (קישור חיצוני) באיחוד האירופי EU
מרכזי נתונים בארצות הברית US

אזורים

בטבלה הבאה מפורטים האזורים באמריקה שבהם נתמך ייצוא נתונים של Channel Services ל-BigQuery.

תיאור האזור שם האזור
איווה us-central1
לאס וגאס us-west4
לוס אנג'לס us-west2
מונטריאול northamerica-northeast1
צפון וירג'יניה us-east4
אורגון us-west1
סולט לייק סיטי us-west3
סאו פאולו southamerica-east1
דרום קרוליינה us-east1

בטבלה הבאה מפורטים האזורים באסיה ובאוקיינוס השקט שבהם נתמך ייצוא נתונים של Channel Services ל-BigQuery.

תיאור האזור שם האזור
הונג קונג asia-east2
ג'קארטה asia-southeast2
מומבאי asia-south1
אוסקה asia-northeast2
סיאול asia-northeast3
סינגפור asia-southeast1
סידני australia-southeast1
טייוואן asia-east1
טוקיו asia-northeast1

בטבלה הבאה מפורטים האזורים באירופה שבהם נתמך ייצוא נתונים של Channel Services ל-BigQuery.

תיאור האזור שם האזור
בלגיה europe-west1
פינלנד europe-north1
פרנקפורט europe-west3
לונדון europe-west2
הולנד europe-west4
ורשה europe-central2
ציריך europe-west6

הפעלת הייצוא

לפני שמפעילים את ייצוא הנתונים, צריך לשים לב למזהה המלא של מערך הנתונים, שהוא בפורמט PROJECT_ID:DATASET_NAME.

כדי להפעיל את הייצוא של נתוני חיוב על שירותים בערוצים שונים:

  1. ב-Partner Sales Console, פותחים את הדף Billing (חיוב).
  2. לוחצים על Billing export.
  3. בשדה Rebilling dataset (מערך נתונים לחיוב חוזר) מזינים את מזהה מערך הנתונים שהוגדר במלואו שבו יישמרו נתוני החיוב.
  4. בוחרים את מקורות הנתונים שרוצים לייצא את הנתונים שלהם.
  5. לוחצים על עדכון. אם מופיעה הודעה שצריך לעדכן את ההרשאות למערך הנתונים, לוחצים על עדכון.

ממשק משתמש להפעלת ייצוא של חיוב מחדש

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

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

יכול להיות שנתוני העלות של החיוב מחדש לא יהיו זמינים למשך התקופה שבה הוא הושבת. אם מחקתם נתונים שיוצאו במהלך התקופה הזו, לא נוכל למלא את החוסרים (backfill) של הרשומות שנמחקו.

הרשאות נדרשות בחשבון שירות

ייצוא הנתונים של שירותים בערוצים מתבצע באמצעות חשבון שירות שנמצא בבעלות Google ומנוהל על ידה, ויש לו הרשאה לכתוב רשומות חיוב בטבלה. חשבון השירות הוא:

cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com

כדי לאפשר ייצוא, לחשבון השירות הזה צריך להיות מוקצה התפקיד המוגדר מראש: roles/bigquery.dataEditor. כדי להגדיר את ההרשאות, פועלים לפי השלבים להפעלת הייצוא.

הרצת שאילתות על נתונים בצורה יעילה

כברירת מחדל, הטבלה ב-BigQuery מחולקת למחיצות לפי export_time ומקובצת לאשכולות לפי payer_billing_account_id. כלומר, הטבלה מחולקת למחיצות קטנות יותר, וכל אחת מהן מחולקת לקלאסטרים קטנים יותר. שימוש במפתחות של מחיצות ושל אשכולות בשאילתה עוזר ל-BigQuery לאתר במהירות את הנתונים הרלוונטיים, ויכול להפחית באופן משמעותי את העלות של השאילתה.

לדוגמה, השאילתה הזו יעילה בהשוואה לשאילתה ללא מפתחות חלוקה ומפתחות אשכול:

SELECT
  billing_account_id
  currency,
  invoice.month,
  -- Divide by currency_conversion_rate if converting non-USD to USD.
  SUM(cost)
    + SUM(
      IFNULL(
        (SELECT SUM(c.amount) FROM UNNEST(credits) AS c), 0))
    AS total
FROM PROJECT_ID.DATASET_NAME.reseller_billing_detailed_export_v1
WHERE
  export_time BETWEEN TIMESTAMP(START_DATE)
    AND TIMESTAMP(END_DATE)
  AND payer_billing_account_id IN (PAYER_BILLING_ACCOUNT_IDS)
GROUP BY
  billing_account_id,
  currency,
  invoice.month
ORDER BY
  billing_account_id,
  currency,
  invoice.month;

מידע נוסף על חלוקה למחיצות, אשכולות ושיטות מומלצות זמין בקישורים הבאים:

  1. הרצת שאילתות על טבלאות מחולקות למחיצות
  2. הרצת שאילתות על טבלאות מסודרות באשכולות
  3. שיפור חישוב השאילתות
  4. שיטות מומלצות לניהול העלויות ב-BigQuery

איתור מזהה החשבון לחיוב של המשלם

כדי למצוא את מזהה החשבון לחיוב של המשלם, פותחים את הדף 'חשבונות לחיוב' ב-Partner Sales Console ולוחצים על הכרטיסייה Partner billing (חיובים של שותפים).

תוכלו לראות את כל החשבונות לחיוב ואת המזהים של החשבונות לחיוב של המשלמים.

מזהה החשבון לחיוב של המשלם

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

יש כמה דרכים להגדיר בקרת גישה לנתונים ב-BigQuery Export. מידע נוסף זמין במאמר בנושא אמצעי בקרת גישה ב-BigQuery.

כדי לוודא שלמשתמשים תהיה גישה רק לנתונים שהם מורשים לראות, מומלץ להגדיר תצוגות מורשות כדי לשתף נתונים ממערך הנתונים המיוצא.

כשמגדירים הרשאות למשתמשים לצורך ייצוא רציף של נתונים, חשוב לוודא שלחשבון השירות cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com תמיד יש גישת עריכה מלאה למערך הנתונים של הייצוא.

סכמת טבלאות

הסכימה הבאה מתארת את הנתונים בטבלה ב-BigQuery.

במערך הנתונים ב-BigQuery, הייצוא המפורט של החיוב מחדש נטען לטבלת נתונים שנקראת reseller_billing_detailed_export_v1.

שדה סוג תיאור
billing_account_id String מספר החשבון שאליו משויך השימוש, שיכול להיות של הלקוח או שלכם. בהתאם למשפחת המוצרים, זה יכול להיות חשבון לחיוב או Cloud Identity.
payer_billing_account_id String המזהה של החשבון הראשי לחיוב.
invoice.month String השנה והחודש (בפורמט YYYYMM) של החשבונית שכוללת את פריטי העלות. לדוגמה: המחרוזת '202101' מייצגת את ינואר 2021.
cost_type String סוג העלות שהפריט הזה מייצג: רגילה, מס, התאמה או שגיאת עיגול.
service.id String מזהה השירות שאליו משויך השימוש.
service.description String השירות של Google שדיווח על נתוני החיוב.
sku.id String מזהה המק"ט של המשאב שהיה בשימוש של השירות.
sku.description String תיאור של סוג המשאב שהשירות השתמש בו. לדוגמה, Cloud Storage הוא מסוג Standard Storage US.
usage_start_time חותמת הזמן שעת ההתחלה של חלון השימוש השעתי שבו חושבה העלות. נתוני השימוש והעלויות של כל השירותים מוצגים ברמת פירוט שעתית. שימוש ארוך בשירות יכול להתפרס על פני מספר חלונות שימוש שעתיים. במוצרים שמבוססים על מינוי, זהו תחילת חודש החיוב.
usage_end_time חותמת הזמן שעת הסיום של חלון השימוש השעתי שבו חושבה העלות. נתוני השימוש והעלויות של כל השירותים מוצגים ברמת פירוט שעתית. שימוש ארוך בשירות יכול להתפרס על פני מספר חלונות שימוש שעתיים. במוצרים מסוג מינוי, זהו סוף חודש החיוב.
project Struct מידע על הפרויקט ב- Google Cloud שבו נוצרו נתוני החיוב ב-Cloud.
project.number String מזהה ייחודי שנוצר באופן פנימי ועבר אנונימיזציה לפרויקט ב- Google Cloud שבו נוצרו נתוני החיוב ב-Cloud.
project.id String מזהה הפרויקט ב- Google Cloud שבו נוצרו נתוני החיוב ב-Cloud.
project.name String שם הפרויקט ב- Google Cloud שבו נוצרו נתוני החיוב ב-Cloud.
project.labels Struct, Repeated
project.labels.key String אם יש תוויות, זה החלק של המפתח בצמדי מפתח/ערך.
project.labels.value String אם יש תוויות, זה החלק של הערך בצמדי מפתח/ערך.
project.ancestry_numbers String ישות האב בהיררכיית המשאבים של הפרויקט שמזוהה על ידי הערך שצוין בשדה project.id.
labels Struct, Repeated
labels.key String אם יש תוויות, זה החלק של המפתח בצמדי מפתח/ערך.
labels.value String אם יש תוויות, זה החלק של הערך בצמדי מפתח/ערך.
system_labels Struct, Repeated
system_labels.key String אם קיימות תוויות ברמת המערכת, זהו החלק של המפתח בצמדים של מפתח/ערך.
system_labels.value String אם יש תוויות ברמת המערכת, זה החלק של הערך בצמדי מפתח/ערך.
location.location String המיקום שבו נוצר השימוש ברמה של מדינה, אזור או תחום (zone). הערך global מוצג למשאבים שאין להם מיקום ספציפי. מידע נוסף זמין במאמר אזורים ואזורי זמינות.
location.country String כשהשדה location.location מכיל מדינה, אזור או תחום (zone), הוא כולל את המדינה שבה היה השימוש. לדוגמה, US. מידע נוסף זמין במאמר אזורים ואזורי זמינות.
location.region String כשהשדה location.location מכיל מדינה או אזור, הוא כולל את האזור שבו היה השימוש. לדוגמה, us-central1. מידע נוסף זמין במאמר אזורים ואזורי זמינות.
location.zone String כשהשדה location.location מכיל תחום (zone), הוא כולל את התחום שבו היה השימוש. לדוגמה, us-central1-a. מידע נוסף זמין במאמר אזורים ואזורי זמינות.
resource Struct תיאור של המבנה והערכים של הנתונים שרלוונטיים למשאבי השירות (למשל, מכונות וירטואליות או SSD) שמייצרים את השימוש בשירות.
resource.name String מזהה ספציפי לשירות של המשאב שיצר את השימוש הרלוונטי. יכול להיות שנוצר על ידי המשתמש.
resource.global_name String מזהה שירות ייחודי וגלובלי של המשאב שיצר את השימוש הרלוונטי.
cost Numeric העלות לפי מודל הצריכה הרלוונטי, כולל הנחות מוסכמות שמופיעות בתמחור המותאם אישית בחוזה שמקושר לחשבון לחיוב ב-Cloud (אם רלוונטי).
currency String המטבע שבו מחויבת העלות. מידע נוסף זמין במאמר מטבע מקומי לחיוב ולתשלומים.
currency_conversion_rate Float שער החליפין מדולר ארה"ב למטבע המקומי. כלומר, התוצאה של החישוב ‎cost ÷ currency_conversion_rate‎ היא העלות בדולר ארה"ב.
usage.amount Numeric הכמות של usage.unit שהיו בשימוש.
usage.unit String היחידה הבסיסית שלפיה נמדד השימוש במשאבים. לדוגמה, היחידה הבסיסית של אחסון סטנדרטי היא byte-seconds.
usage.amount_in_pricing_unit Numeric כמות השימוש ב-usage.pricing_unit.
usage.pricing_unit String היחידות למדידת השימוש במשאבים.
credits Struct, Repeated מכיל שדות שמתארים את המבנה ואת הערך של הזיכויים.
credits.id String אם השדה הזה מאוכלס, המשמעות היא שהשדה הזה משויך למק"ט של המוצר.
credits.full_name String שם הזיכוי שמשויך למק"ט של המוצר.
credits.type String השדה הזה מתאר את המטרה או המקור של credits.id.
credits.name String תיאור של הזיכוי שהוחל על השימוש.
credits.amount Numeric סכום הזיכוי שהוחל על השימוש.
credits.channel_partner_amount Numeric סכום הזיכוי שהוחל על השימוש, אחרי הנחות ועלויות נוספות של חיוב חוזר. על סמך channel_partner_name וChannelPartnerRepricingConfig המשויך. אם credits.type הוא RESELLER_MARGIN, הסכום הזה יהיה אפס.
credits.customer_amount Numeric סכום הזיכוי שהוחל על השימוש, אחרי הנחות ועלויות נוספות של חיוב חוזר. על סמך customer_name וCustomerRepricingConfig המשויך. אם credits.type הוא RESELLER_MARGIN, הסכום הזה יהיה אפס.
adjustmentsInfo Struct, Repeated מכיל שדות שמתארים את המבנה ואת הערך של התאמה לפריטי עלות.
adjustmentsInfo.adjustment_id String אם השדה הזה מאוכלס, המשמעות היא שהתאמה משויכת לפריט מסוים של עלות. ‫adjustmentsInfo.adjustments_id הוא המזהה הייחודי של כל ההתאמות שנגרמו על ידי בעיה.
adjustmentsInfo.adjustment_description String תיאור של ההתאמה והסיבה שבגללה היא בוצעה.
adjustmentsInfo.adjustment_type String סוג ההתאמה.
adjustmentsInfo.adjustment_mode String האופן שבו הונפקה ההתאמה.
export_time חותמת הזמן משתנה שמייצג את הזמן שבו בוצע העיבוד ומשויך לתוספת נתוני החיוב. הערך בשדה הזה יגדל בכל ייצוא חדש. על סמך המידע בעמודה export_time אפשר לדעת מתי עודכנו לאחרונה נתוני החיוב שיוצאו.
entitlement_name String שם המשאב של ההרשאה ב-Cloud Channel API. הפורמט הוא: accounts/{account}/customers/{customer}/entitlements/{entitlement}
channel_partner_name String (מפיצים בלבד) שם המשאב של שותף ראשי שמוכר ללקוח הקצה. הפורמט הוא: accounts/{account}/channelPartnerLinks/{channelPartner}.
channel_partner_cost Numeric (מפיצים בלבד) העלות לשותף הראשי, שמזוהה על ידי channel_partner_name, אחרי החלת ChannelPartnerRepricingConfig קיים.
customer_name String שם המשאב של הלקוח של המפיץ שצרך את השימוש הזה בפורמט accounts/{account}/customers/{customer}
customer_cost Numeric העלות ללקוח של המפיץ שמזוהה בעמודה customer_name, אחרי החלת CustomerRepricingConfig, אם קיים.
cost_at_list Numeric מחיר המחירון של העלות לפי מודל הצריכה שמוגדר כברירת מחדל.
customer_repricing_config_name String שם המשאב של Cloud Channel API‏ CustomerRepricingConfig. הפורמט הוא: accounts/{account}/customers/{customer}/customerRepricingConfigs/{id}.
channel_partner_repricing_config_name String (מפיצים בלבד) שם המשאב של Cloud Channel API‏ ChannelPartnerRepricingConfig. הפורמט הוא: accounts/{account}/channelPartnerLinks/{channelPartner}/channelPartnerRepricingConfigs/{id}.
tags Struct שדות שמתארים את התג, כמו מפתח, ערך ומרחב שמות.
tags.key String השם המקוצר או השם המוצג של המפתח שמשויך לתג הספציפי הזה.
tags.value String המשאבים שמצורפים למפתח תג. בכל רגע נתון אפשר לצרף רק ערך אחד לכל משאב של מפתח נתון.
tags.inherited בוליאני השדה הזה מציין אם הקישור בין התגים הוא בירושה (Tags Inherited = True) או ישיר/לא בירושה (Tags Inherited = False).
tags.namespace String השדה הזה מייצג את היררכיית המשאבים שמגדירה את המַפְתח והערכים של התג. אפשר לשלב את מרחב השמות עם השמות המקוצרים של מפתח וערך התג, כדי ליצור שם ייחודי גלובלי שמוגדר במלואו למפתח או לערך של התג.
customer_correlation_id String מזהה ה-CRM החיצוני של הלקוח. השדה הזה מאוכלס רק אם קיים מזהה CRM ללקוח הזה.
price Struct שדות שמתארים את המבנה והערכים שקשורים למחירים שחויבו על שימוש.
price.effective_price Numeric מחיר המק"ט לפי מודל הצריכה הרלוונטי, כולל הנחות מוסכמות שמופיעות בתמחור המותאם אישית בחוזה שמקושר לחשבון לחיוב ב-Cloud (אם רלוונטי).
price.tier_start_amount Numeric הרף התחתון של מספר היחידות ברמת תמחור של מק"ט. למידע נוסף, ראו רמות תמחור.
price.unit String יחידת השימוש שבה מצוין התמחור ושבה נמדד השימוש במשאב.
price.pricing_unit_quantity Numeric הרף התחתון של מספר היחידות ברמת תמחור של מק"ט. למידע נוסף, ראו רמות תמחור.
price.list_price Numeric מחיר המחירון של המק"ט לפי מודל הצריכה שמוגדר כברירת מחדל.
price.effective_price_default Numeric מחיר המק"ט לפי מודל הצריכה שמוגדר כברירת מחדל, כולל הנחות מוסכמות שמופיעות בתמחור המותאם אישית בחוזה שמקושר לחשבון לחיוב ב-Cloud (אם רלוונטי).
price.list_price_consumption_model Numeric מחיר המחירון של המק"ט לפי מודל הצריכה הרלוונטי, לפני שההנחות המוסכמות מופיעות בתמחור המותאם אישית בחוזה שמקושר לחשבון לחיוב ב-Cloud (אם רלוונטי).
transaction_type String סוג הטרנזקציה של המוכר. סוג הטרנזקציה יכול להיות אחד מהערכים האלה:
  • ‫GOOGLE = 1: שירותים שנמכרים על ידי Google Cloud.
  • ‫THIRD_PARTY_RESELLER = 2: שירותים של צד שלישי שמופצים על ידי Google Cloud.
  • ‫THIRD_PARTY_AGENCY = 3: שירותים של צד שלישי שנמכרים על ידי שותף, כאשר Google Cloud פועל כסוכן.
seller_name String השם החוקי של המוכר. Google Cloud
subscription Struct השדות שמתארים את ההתחייבויות שלכם להוצאה או לשימוש במשאבים. אפשר להשתמש בשדות האלה כדי לנתח את החיובים לפי התחייבויות ספציפיות.
subscription.instance_id String מזהה המינוי שמקושר להתחייבות.
cost_at_effective_price_default Numeric העלות לפי מודל הצריכה שמוגדר כברירת מחדל, כולל הנחות מוסכמות שמופיעות בתמחור המותאם אישית בחוזה שמקושר לחשבון לחיוב ב-Cloud (אם רלוונטי).
cost_at_list_consumption_model Numeric העלות לפי מודל הצריכה הרלוונטי, לפני שההנחות המוסכמות מופיעות בתמחור המותאם אישית בחוזה שמקושר לחשבון לחיוב ב-Cloud (אם רלוונטי).
consumption_model Struct שדות שמתארים את מודל הצריכה הרלוונטי.
consumption_model.id String המזהה של מודל הצריכה.
consumption_model.description String התיאור של מודל הצריכה.

הערות נוספות לגבי הסכימה

יש כמה הערות נוספות לגבי הסכימה.

עמודות שלא רלוונטיות ל-Google Workspace

אם עמודה או שדה לא רלוונטיים למשפחת מוצרים, הנתונים המיוצאים של משפחת המוצרים הזו יכללו null בשדה הזה. השדות הבאים לא רלוונטיים לייצוא ל-Google Workspace:

  • project
  • labels
  • resource
  • credits
  • adjustmentsInfo
  • customer_repricing_config_name
  • channel_partner_repricing_config_name
  • tags
  • price.effective_price
  • price.tier_start_amount
  • price.list_price
  • price.effective_price_default
  • price.list_price_consumption_model
  • transaction_type
  • seller_name
  • consumption_model

עמודות שלא רלוונטיות למק"טים של Google Workspace עם חיוב לפי צריכה

אם עמודה או שדה לא רלוונטיים למשפחת מוצרים, הנתונים המיוצאים של משפחת המוצרים הזו יכללו null בשדה הזה. השדות הבאים לא רלוונטיים לייצוא ל-Google Workspace:

  • service.id
  • sku.id
  • project
  • labels
  • resource
  • customer_repricing_config_name
  • channel_partner_repricing_config_name
  • tags
  • price.effective_price
  • price.tier_start_amount
  • transaction_type
  • seller_name
  • subscription

עמודות שלא רלוונטיות להזמנות אופליין (תצוגה מקדימה)

אם עמודה או שדה לא רלוונטיים למשפחת מוצרים, הנתונים המיוצאים של משפחת המוצרים הזו יכללו null בעמודה או בשדה האלה. העמודות או השדות הבאים לא רלוונטיים לייצוא של נתוני חיוב על הזמנות אופליין:

  • project
  • labels
  • system_labels
  • location
  • resource
  • credits
  • entitlement_name
  • channel_partner_name
  • channel_partner_cost
  • customer_name
  • customer_cost
  • cost_at_list
  • customer_repricing_config_name
  • channel_partner_repricing_config_name
  • tags
  • price.effective_price
  • price.tier_start_amount
  • price.list_price
  • price.effective_price_default
  • price.list_price_consumption_model
  • transaction_type
  • seller_name
  • consumption_model

הערות נוספות לגבי ייצוא מ-Google Workspace

יש כמה התנהגויות מיוחדות בייצוא מ-Google Workspace:

  • הנתונים ב-Google Workspace לא כוללים את השימוש של המשווק עצמו.
  • כשהערך בשדה cost_type הוא tax וגם adjustment, הערך בשדה usage.amount_in_pricing_units תמיד יהיה 1.
  • בחשבוניות של Google Workspace, המיסים מוצגים כפריט אחד. בייצוא, המיסים מפורטים לפי לקוח. הסכום הכולל של המס צריך להיות זהה לסכום בחשבונית, אבל יכול להיות שיהיו אי דיוקים קלים בעיגול של סכומי המס הבודדים.

billing_account_id

  • ב- Google Cloud, זהו החשבון לחיוב ב-Cloud שאליו משויך השימוש.
  • ב-Google Workspace, זהו מזהה Cloud Identity של הלקוח.
  • בהזמנות ללא חיבור לאינטרנט, זהו שם הלקוח.

service וגם sku

ב-Google Workspace, העמודות האלה מייצגות את ה"מוצר" ואת "מק"ט" שמשויכים לשימוש. מידע נוסף על מזהי מוצרים ומזהי מק "טים .

במק"טים של Google Workspace שמתבססים על צריכה (Google Voice ו-Drive), העמודות sku.id ו-service.id מכילות null.

usage_start_time וגם usage_end_time

בקובץ ה-CSV של החשבונית של Google Workspace, הנתונים האלה מיוצגים כתאריכים. בייצוא, הן מיוצגות כחותמות זמן:

  • במקרה של usage_start_time, זו שעת ההתחלה (כולל) של המינוי, בשעה 0:00 לפי שעון החוף המערבי בארה"ב בתאריך ההתחלה.
  • במקרה של usage_end_time, זו שעת הסיום (לא כולל) של המינוי, בשעה 0:00 לפי שעון החוף המערבי ביום אחרי תאריך הסיום.

project.labels

ב- Google Cloud, אלה צמדי מפתח/ערך בפרויקט ב-Google Cloud שבו נוצר השימוש. מידע נוסף זמין במאמר שימוש בתוויות.

labels

ב- Google Cloud, אלה צמדי מפתח/ערך במשאב ב- Google Cloudשבו נוצר השימוש. מידע נוסף זמין במאמר שימוש בתוויות.

system_labels

  • ב- Google Cloud, אלה צמדי מפתח/ערך במשאב ב-Google Cloud שבו נוצר השימוש. מידע נוסף זמין במאמר תוויות מערכת זמינות.

  • ב-Google Workspace, אלה מטא-נתונים נוספים לגבי העלות, שכוללים:

    • ‫workspace.googleapis.com/domain_name: שם הדומיין של הלקוח.
    • ‫workspace.googleapis.com/order_id: מזהה ההזמנה.
    • ‫workspace.googleapis.com/purchase_order_id: מזהה הזמנת הרכש (PO).
    • ‫workspace.googleapis.com/subscription_id: מזהה המינוי.
    • ‫workspace.googleapis.com/usage_type: סוג השימוש. לא רלוונטי אם cost_type לא regular.

סוגי השימוש ב-Google Workspace כוללים:

  • ‫COMMITMENT_TERM_START_ITEM: תחילת מינוי. בדרך כלל, המונח הזה קשור למינוי עם התחייבות חודשית שמוגדר לחיוב חלקי של חודש, ולתקופת החיוב או החוזה של מינוי בתשלום מראש.
  • ‫COMMITMENT_TERM_END_ITEM: סיום של מינוי. בדרך כלל קשור לחיובים של החודש האחרון במינוי עם התחייבות לתשלום חודשי.
  • ‫COMMITMENT_TERM_RENEWAL_ITEM: תחילת תקופת מינוי המשך.
  • ‫COMMITMENT_MONTHLY_ITEM: השימוש שנרשם עבור התחייבויות שהיו קיימות בתחילת החודש. ברוב המקרים, החיוב יתבצע לאורך כל החודש.
  • ‫COMMITMENT_SEATS_CHANGE_ITEM: נרשם כשמשנים את רמת ההתחייבות (הגדלה או הקטנה). לרוב מתחיל באמצע החודש ונמשך עד סוף החודש במינוי עם התחייבות לתשלום חודשי, או עד סוף תקופת החיוב או החוזה במינוי בתשלום מראש.
  • ‫COMMITMENT_CANCEL_ITEM: נרשם כשמינוי מבוטל. כולל חיובים שקשורים לביטול מוקדם. הערך מייצג חיוב על שארית תקופת החוזה במקרה של ביטול חוזה באמצע התקופה, או זיכוי על שארית תקופת החיוב במקרה של שינוי או ביטול חוזה באמצע התקופה.
  • FLEXIBLE_SEATS_ITEM: מתעד את השימוש של מספר מסוים של משתמשים במשך תקופה רצופה של מספר מסוים של ימים. מיועד רק למשתמשים ללא התחייבות.
  • ‫COUPON_DISCOUNT_ITEM: סכום ההנחה שמשויך לשובר.
  • ‫MIGRATED_CREDIT_ITEM: זיכוי מהעברה מ-Postini.
  • ‫COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: מייצג פרטי שימוש שנוצרים בתחילת מחזור החיובים עבור המחזור כולו במינוי עם התחייבות לתשלום מראש.

usage.amount

בשימוש ב-Google Workspace לפי מספר המושבים, הערך הזה מציין מושבים בתשלום. לדוגמה, מושבים בהתחייבות למינויים או מספר מושבים בתשלום למינויים גמישים.

במק"טים של Google Workspace שמתבססים על צריכה (Google Voice ו-Drive), זהו מספר הדקות שהיו בשימוש.

usage.pricing_unit

  • למידע נוסף על Google Cloud, אפשר לקרוא על Cloud Billing Catalog API.{: track-type="tasks" class="external" track-name="externalLink" track-metadata-position="body"}
  • ב-Google Workspace, זהו count.

credits.id

הערך של Google Cloudיכול להיות מזהה ייחודי אלפאנומרי (למשל 12-b34-c56-d78), או תיאור של סוג האשראי (למשל Committed Usage Discount: CPU). אם השדה credits.id ריק, המשמעות היא שמק"ט המוצר לא משויך לזיכוי כלשהו.

credits.full_name

במקרה של Google Cloud, זהו תיאור קריא לאנשים של ערך אלפאנומרי credits.id. לדוגמה: Free trial credit או הנחה תמורת התחייבות להוצאה. הערכים של credits.full_name מאוכלסים רק למק"טים עם ערך אלפאנומרי בשדה credits.id. אם הערך של credits.id הוא תיאור של סוג האשראי (למשל Committed Usage Discount: CPU), השדה credits.full_name יהיה ריק.

credits.type

במקרה של Google Cloud, סוגי הזיכויים כוללים:

  • ‫COMMITTED_USAGE_DISCOUNT: חוזים של התחייבות לשימוש במשאבים שנרכשו בשביל Compute Engine בתמורה להנחות משמעותיות בשימוש במכונות וירטואליות.
  • ‫COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE : חוזים של התחייבות להוצאה שנרכשו בשביל שירותים, בתמורה להתחייבות שלכם לשלם סכום מינימלי על השירותים.
  • ‫DISCOUNT: סוג האשראי הזה משמש לזיכויים שנצברו אחרי שהגעתם לסף ההוצאות שמוגדר בחוזה. שימו לב שבדוחות של החיוב ב-Cloud שזמינים במסוף תוכנית המכירות של שותפי YouTube, סוג האשראי מסוג הנחה מופיע בתור Spending based discounts (contractual).
  • ‫FREE_TIER: בשירותים מסוימים אפשר להשתמש בחינם במשאבים עד למגבלות מסוימות. בשירותים האלה, מממשים את הזיכויים כדי להשתמש בתוכנית ללא תשלום.
  • ‫PROMOTION: סוג האשראי לקידום מכירות כולל תקופת ניסיון בחינם ב-Google Cloud וקרדיטים של קמפיין שיווקי או מענקים אחרים לשימוש ב- Google Cloud. כשהאפשרות של שובר פרסום זמינה, היא נחשבת כאמצעי תשלום והמערכת מחילה אותה באופן אוטומטי כדי להקטין את החיוב הכולל.
  • ‫RESELLER_MARGIN: אם אתם מפיצים, סוג האשראי הנחת מפיצים מציין את ההנחות שנצברו בתוכנית המפיצים בכל פריט שעומד בדרישות.
  • ‫SUBSCRIPTION_BENEFIT: זיכויים שצברתם על ידי רכישת מינויים לטווח ארוך לשירותים בתמורה להנחות.
  • ‫SUSTAINED_USAGE_DISCOUNT: סוג הזיכוי 'הנחה על שימוש קבוע' מייצג הנחה אוטומטית שאתם מקבלים על הפעלת משאבים ספציפיים של Compute Engine בחלק משמעותי של החיוב החודשי.

adjustmentsInfo

במקרה של Google Cloud, הערכים האלה מאוכלסים רק אם פריט העלות נוצר בעקבות שינוי בחיוב ב-Cloud. הסוג adjustmentsInfo כולל פרטים לגבי ההתאמה, לא משנה אם היא הונפקה לצורך תיקון שגיאה או מסיבה אחרת.

adjustmentsInfo.adjustment_type

במקרה של Google Cloud, זה כולל:

  • ‫USAGE_CORRECTION: תיקון בגלל דיווח שגוי של שימוש.
  • ‫PRICE_CORRECTION: תיקון בגלל כללי תמחור שגויים.
  • ‫METADATA_CORRECTION: תיקון של מטא-נתונים בלי לשנות את העלות.
  • ‫GOODWILL: זיכוי שהונפק ללקוח מטעמי מוניטין.
  • ‫SALES_BASED_GOODWILL: זיכוי שהונפק ללקוח מטעמי מוניטין במסגרת חוזה.
  • ‫SLA_VIOLATION: זיכוי שהונפק ללקוח בגלל הפרה של יעדים למדידת רמת השירות (SLO).
  • ‫BALANCE_TRANSFER: התאמה לצורך העברת כספים מחשבון תשלומים אחד לאחר.
  • ‫ACCOUNT_CLOSURE: התאמה שמאפסת את היתרה של חשבון סגור.
  • ‫GENERAL_ADJUSTMENT: שינוי כללי בחשבון לחיוב ב-Cloud.

adjustmentsInfo.adjustment_mode

במקרה של Google Cloud, זה כולל:

  • ‫PARTIAL_CORRECTION: התיקון מבטל חלקית את השימוש והעלות המקוריים.
  • ‫COMPLETE_NEGATION_WITH_REMONETIZATION: התיקון מבטל לחלוטין את השימוש והעלות המקוריים, ומפיק שורות פריטים מתוקנות עם שימוש ועלות מעודכנים.
  • ‫COMPLETE_NEGATION: התיקון מבטל לחלוטין את השימוש והעלות המקוריים, ואין חיוב על שימוש נוסף.
  • ‫MANUAL_ADJUSTMENT: ההתאמה של העלות והשימוש מבוצעת באופן ידני.

price.effective_price

ב- Google Cloud, זהו המחיר שחויב על השימוש במק"טים שלGoogle Cloud או של Google Maps Platform, ורמות התמחור של המק"טים. אם העלויות בחשבון לחיוב ב-Cloud מוגדרות לפי חוזה עם מחיר מוסכם ומותאם אישית, המחיר הזה ספציפי לחשבון לחיוב ב-Cloud. אחרת, זהו מחיר המחירון של המק"ט או של רמת המק"ט.