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

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

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

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

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

{
  "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 של המינוי. אם הלקוח ישתנה מהמק"ט המקורי, ההנחה תוסר.

קודי עסקאות לא נכנסים לתוקף בנסיבות הבאות:

יצירת תוכניות לתקופת ניסיון

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

העברת מינויים

• המחיר הרגיל נכנס לתוקף אם מעבירים מינוי בהנחה.

כדי ליצור מינוי בהנחה בתוכנית שנתית בחשבון לקוח חדש, צריך להשתמש בבקשת ה-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"
}

העברת מינוי

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

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

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