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

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

  • מינוי עם התחייבות שנתית
  • מינוי גמיש
  • תקופת ניסיון בחינם למשך 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"
}

העברת מינוי

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

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

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