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

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

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

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

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

לקוחות עם customerType = 'team' יכולים לרכוש רק את מהדורות Essentials ו-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: המזהה הייחודי של המק"ט. מידע נוסף זמין במאמר בנושא מזהי מוצרים ומק "טים.
  • ‫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: המזהה הייחודי של המק"ט. מידע נוסף זמין במאמר בנושא מזהי מוצרים ומק "טים.
  • ‫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: המזהה הייחודי של המק"ט. מידע נוסף זמין במאמר בנושא מזהי מוצרים ומק "טים.
  • ‫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: המזהה הייחודי של המק"ט. מידע נוסף זמין במאמר בנושא מזהי מוצרים ומק "טים.
  • ‫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 יום.

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

כדי להעביר את המינוי של לקוח בתוכנית התחייבות שנתית, משתמשים בבקשת ה-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: המזהה הייחודי של המק"ט. מידע נוסף זמין במאמר בנושא מזהי מוצרים ומק "טים.
  • ‫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 ולמידע על המוצרים שבהם נעשה שימוש בתוכניות האלה

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