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

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

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

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

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