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

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

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

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

{
  "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 של המק"ט שצריך להעביר. הפונקציה מחזירה את transferInfo.currentLegacySkuId, שהוא skuId של מק"ט שהלקוח קיבל בפועל. לרשימה מלאה של skuIds ולמידע על המוצרים שכלולים בתוכניות האלה, אפשר לעיין במוצרים ומקט "ים.

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