יצירה או העברה של מינוי

אחרי שמזמינים חשבון של לקוח, אפשר ליצור מספר מינויים שונים:

  • מינוי עם התחייבות שנתית
  • מינוי גמיש
  • תקופת ניסיון בחינם למשך 30 ימים
  • מינוי בהנחה

מידע נוסף על המוצרים שבהם נעשה שימוש במינויים האלה זמין במאמר מוצרים ומק "טים.

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

לקוחות עם customerType = 'team' יכולים לרכוש רק את מהדורות Google Workspace Essentials ו-Google Workspace Enterprise Essentials של Google Workspace. אם תנסו לרכוש מינויים אחרים ל-Google Workspace, תוצג השגיאה: Customer is not eligible to purchase this subscription. יכול להיות שלקוחות שרוכשים מינויים ל-Essentials או מינויים מבוססי-שימוש לא יוכלו להשתמש בתוכניות עם התחייבות שנתית, והאפשרויות שלהם לשדרוג ולשנמוך יהיו מוגבלות.

יצירת מינוי

כדי ליצור מינוי לחשבון של לקוח חדש, משתמשים בבקשת ה-HTTP הבאהPOST וכוללים את אסימון ההרשאה:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

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

יצירת תוכנית התחייבות שנתית

במינויים עם התחייבות שנתית, לא לכל המק"טים יש את אותן הגדרות ברירת מחדל לחידוש. מומלץ להעביר תמיד את הערך renewalSettings. יצירת מינוי עם התחייבות שנתית ל-10 משתמשים:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  "renewalSettings": {
    "renewalType": "RENEW_CURRENT_USERS_MONTHLY_PAY"
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CUSTOMER_ID: שם הדומיין הראשי של הלקוח או המזהה הייחודי של הלקוח.
  • ‫SKU_ID: המזהה הייחודי של המספר הקטלוגי (SKU). מידע נוסף זמין במאמר בנושא מזהי מוצרים ומק "טים.
  • ‫PURCHASE_ORDER_ID: מזהה הזמנת רכש אופציונלי שאפשר להשתמש בו כדי לעקוב אחרי השימוש.

תגובה מוצלחת מחזירה סטטוס HTTP 200 ואת ההגדרות של המינוי החדש לתוכנית עם התחייבות שנתית. ANNUAL_MONTHLY_PAY מוחזר כ-ANNUAL בכל התגובות של ה-API.

דוגמה לתשובה לגבי תוכנית שנתית:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "purchaseOrderId": "my_example.com_annual_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

יצירת תוכנית גמישה

כדי ליצור מינוי גמיש לחשבון של לקוח חדש, משתמשים בבקשת ה-HTTP הבאה POST וכוללים את אסימון ההרשאה:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "FLEXIBLE"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CUSTOMER_ID: שם הדומיין הראשי של הלקוח או המזהה הייחודי של הלקוח.
  • ‫SKU_ID: המזהה הייחודי של המספר הקטלוגי (SKU). מידע נוסף זמין במאמר בנושא מזהי מוצרים ומק "טים.
  • ‫PURCHASE_ORDER_ID: מזהה הזמנת רכש אופציונלי שאפשר להשתמש בו כדי לעקוב אחרי השימוש.

זוהי דוגמה לתשובה של תוכנית גמישה:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "FLEXIBLE",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10,
    "licensedNumberOfSeats": 0
  },
  "trialSettings": {
    "isInTrial": false
  },
  "purchaseOrderId": "my_example_flex_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

יצירת תקופת ניסיון בחינם

כדי ליצור מינוי ל-30 ימי ניסיון בחינם לחשבון של לקוח חדש, צריך להשתמש בבקשת ה-HTTP הבאה ולכלול את אסימון ההרשאה:POST

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "TRIAL"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CUSTOMER_ID: שם הדומיין הראשי של הלקוח או המזהה הייחודי של הלקוח.
  • ‫SKU_ID: המזהה הייחודי של המספר הקטלוגי (SKU). מידע נוסף זמין במאמר בנושא מזהי מוצרים ומק "טים.
  • ‫PURCHASE_ORDER_ID: מזהה הזמנת רכש אופציונלי שאפשר להשתמש בו כדי לעקוב אחרי השימוש.

זוהי דוגמה לתגובה של תוכנית עם תקופת ניסיון בחינם למשך 30 יום:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "TRIAL",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10,
    "licensedNumberOfSeats": 0
  },
  "trialSettings": {
    "isInTrial": true,
    "trialEndTime": "1331648420142"
  },
  "purchaseOrderId": "my_example_trial_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

יצירת הנחה על מינוי

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

כדי ליצור מינוי שנתי עם הנחה לחשבון של לקוח חדש, משתמשים בבקשת ה-HTTP הבאה POST וכוללים את אסימון ההרשאה:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  "renewalSettings": {
    "renewalType": "RENEW_CURRENT_USERS_MONTHLY_PAY"
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID",
  "dealCode": "GOOGLE_CONTRACT_DEAL_CODE"
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CUSTOMER_ID: שם הדומיין הראשי של הלקוח או המזהה הייחודי של הלקוח.
  • ‫SKU_ID: המזהה הייחודי של המספר הקטלוגי (SKU). מידע נוסף זמין במאמר בנושא מזהי מוצרים ומק "טים.
  • ‫PURCHASE_ORDER_ID: מזהה הזמנת רכש אופציונלי שאפשר להשתמש בו כדי לעקוב אחרי השימוש.
  • ‫GOOGLE_CONTRACT_DEAL_CODE: קוד הנחה שזמין מ-Google.

דוגמה לתשובה לגבי תוכנית שנתית עם הנחה:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "purchaseOrderId": "my_example.com_annual_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "dealCode": "GOOGLE_CONTRACT_DEAL_CODE",
  "skuName": "Google Workspace Business Standard"
}

העברת מינוי

אם לא הזמנתם את החשבון של הלקוח באמצעות הפעולה order a new customer account, אתם צריכים להשתמש בטוקן ההעברה של הלקוח כשאתם יוצרים מינוי בשבילו.

כדי ליצור מינוי לחשבון לקוח שלא הזמנתם, משתמשים בבקשת ה-HTTP הבאה:POST

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CUSTOMER_ID: שם הדומיין הראשי של הלקוח או המזהה הייחודי של הלקוח.
  • TOKEN_VALUE: טוקן העברה שסופק על ידי הלקוח. אחרי שהלקוח יוצר את הטוקן, הוא תקף למשך 30 יום.

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

כדי להעביר את המינוי של לקוח בתוכנית התחייבות שנתית, משתמשים בבקשת ה-HTTP הבאה POST וכוללים את טוקן ההרשאה:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions?customerAuthToken=auth token

{
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CUSTOMER_ID: שם הדומיין הראשי של הלקוח או המזהה הייחודי של הלקוח.
  • ‫SKU_ID: המזהה הייחודי של המספר הקטלוגי (SKU). מידע נוסף זמין במאמר בנושא מזהי מוצרים ומק "טים.
  • ‫PURCHASE_ORDER_ID: מזהה הזמנת רכש אופציונלי שאפשר להשתמש בו כדי לעקוב אחרי השימוש.

תגובה מוצלחת מחזירה קוד סטטוס 200 של HTTP ואת ההגדרות של המינוי שהועבר לתוכנית עם התחייבות שנתית:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "purchaseOrderId": "example.com_annual_1",
  "status": "ACTIVE",
  "resourceUiUrl": "URL to customer's Admin console dashboard",
  "skuName": "Google Workspace Business Standard"
}

מגבלות על העברות

אם מעבירים מינוי ל-Google Workspace עם מינוי משויך ל-Google Drive או ל-Google Vault, צריך להשתמש בפעולה batch כדי להעביר את כל המינויים עם סטטוס ACTIVE. העברה של כל מינוי בנפרד גורמת לשגיאה.

העברה של מינויים מושעים מותרת רק אם סיבת ההשעיה היא PENDING_TOS_ACCEPTANCE, TRIAL_ENDED או RENEWAL_WITH_TYPE_CANCEL.

כשמעבירים מק"ט מדור קודם, subscriptions.list מחזירה skuId של המק"ט שצריך להעביר. המערכת מחזירה את skuId של המק"ט שהלקוח קיבל בפועל בתור transferInfo.currentLegacySkuId. לרשימה מלאה של skuIds ולמידע על המוצרים שכלולים בתוכניות האלה, אפשר לעיין במוצרים ומקט "ים.

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