אחרי שאתם מאחזרים את המינוי, אתם יכולים להשתמש במידע מהתגובה המוצלחת כדי לשנות את סטטוס המינוי או לעדכן אותו. בדף הזה נסביר על הדרכים השונות לאחזור ולעדכון של מינויים.
אחזור מינוי
כדי לאחזר מינוי שהוזמנה או הועברה בהצלחה, משתמשים בבקשת ה-HTTP הבאה של GET
.
GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID
מחליפים את מה שכתוב בשדות הבאים:
CUSTOMER_ID
: שם הדומיין הראשי של הלקוח או המזהה הייחודי שלו.SUBSCRIPTION_ID
: מזהה המינוי, שהוא ייחודי לכל לקוח. אפשר לאחזר את הערך הזה באמצעות השיטה Retrieve all reseller subscriptions.
לפעולה הזו אין פרמטרים בגוף הבקשה.
בתגובה מוצלחת מוחזר קוד סטטוס HTTP 200
והגדרות המינוי. בתשובה לדוגמה הבאה, המאפיין isInTrial
הוא false
אבל אין מאפיין trialEndTime
, כלומר הלקוח הזה אף פעם לא נהנה מתקופת ניסיון בחינם של 30 יום בתוכנית הזו.
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"billingMethod": "ONLINE",
"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": "RENEW_CURRENT_USERS_MONTHLY_PAY"
},
"purchaseOrderId": "example.com_annual_1",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
}
אחזור כל המינויים של לקוח
כדי לאחזר את כל המינויים של לקוח מפיץ ספציפי שהוזמנו או הועברו בהצלחה, צריך להשתמש בבקשת ה-HTTP GET
הבאה ולכלול את אסימון ההרשאה:
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID value&pageToken=START_DATE&maxResults=MAX_NUMBER
מחליפים את מה שכתוב בשדות הבאים:
CUSTOMER_ID
: שם הדומיין הראשי של הלקוח או המזהה הייחודי שלו.START_DATE
: תאריך ההתחלה בפורמטYYYY-MM-DD
.MAX_NUMBER
: מספר התוצאות המקסימלי שמוחזר בדף התגובה.
לפעולה הזו אין פרמטרים בגוף הבקשה.
בתגובה מוצלחת מוחזר קוד סטטוס HTTP 200
ורשימת המינויים וההגדרות של הלקוח. רשימת המינויים עשויה לכלול מוצרים שלא מנוהלים בגרסה הזו של Reseller API.
אם הלקוח לא מנוהל על ידכם, תוחזר השגיאה 403 "Forbidden"
.
אחזור של כל המינויים שניתן להעביר ללקוח
כדי לאחזר את כל המינויים של לקוח שאפשר להעביר לניהול של המפיץ, צריך להשתמש בבקשת ה-HTTP הבאה מסוג GET
ולכלול את אסימון ההרשאה. השדה customerId
נדרש והוא המזהה הייחודי של הלקוח שמוחזר כאשר מאחזרים חשבון של לקוח שנמכר מחדש.
השדה customerAuthToken
הוא טוקן העברה שסופק על ידי הלקוח, והוא ספציפי למזהה המפיץ שלכם. לאחר היצירה על ידי הלקוח, התוקף של הקוד הוא למשך 30 יום. מידע נוסף על האופן שבו הלקוחות יוצרים את האסימון זמין במאמר העברת חשבון Google Workspace למפיץ.
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID&customerAuthToken=AUTH_TOKEN&pageToken=START_DATE&maxResults=MAX_NUMBER
מחליפים את מה שכתוב בשדות הבאים:
CUSTOMER_ID
: שם הדומיין הראשי של הלקוח או המזהה הייחודי שלו.AUTH_TOKEN
: טוקן העברה שסופק על ידי הלקוח, והוא ספציפי למזהה המפיץ שלכם. אחרי שהלקוח יוצר את הקוד, הוא תקף למשך 30 יום. מידע נוסף על האופן שבו הלקוחות יוצרים את האסימון זמין במאמר העברת חשבון Google Workspace למפיץ. אם הערך הזה לא תקף או פג תוקפו, תשובת ה-API תחזיר את השגיאה403 "Forbidden"
.START_DATE
: תאריך ההתחלה בפורמטYYYY-MM-DD
.MAX_NUMBER
: מספר התוצאות המקסימלי שמוחזר בדף התגובה.
לפעולה הזו אין פרמטרים בגוף הבקשה.
בתגובה מוצלחת מוחזר קוד סטטוס HTTP 200
ורשימת המינויים של הלקוח שניתנים להעברה, עם תאריך התפוגה של אסימון ההעברה ומספר המקומות המינימלי שנדרש בהזמנת ההעברה. יכול להיות שללקוח יש מינויים נוספים שלא ניתן להעביר.
{
"kind": "reseller#subscriptions",
"subscriptions": [
{
"kind": "subscriptions#subscription",
"customerId": "custId-6543",
"subscriptionId": "432",
"skuId": "1010020028",
"billingMethod": "ONLINE",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"maximumNumberOfSeats": 500,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"transferInfo": {
"transferabilityExpirationTime": "1333183980142",
"minimumTransferableSeats": "20"
},
"purchaseOrderId": "PO_890",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
},
{
"kind": "subscriptions#subscription",
"customerId": "custId-6543",
"subscriptionId": "140",
"skuId": "1010020028",
"creationTime": "1329389322728",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 50
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false,
"trialEndTime": "1331877480016"
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"transferInfo": {
"transferabilityExpirationTime": "1333183780159",
"minimumTransferableSeats": "10"
},
"purchaseOrderId": "",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
},
],
"nextPageToken": "token"
}
אם אתם מתכננים להעביר את המינויים האלה באמצעות פעולת אצווה, צריך להעביר את כל המינויים. העברת כל מינוי בנפרד תגרום לשגיאה. בנוסף, פעולת האצווה מעבירה רק מינויים בסטטוס ACTIVE
. למידע נוסף, ראו העברת מינוי.
אחזור של כל המינויים של המפיץ
כדי לאחזר את כל המינויים שהמפיץ הזמין או העביר בהצלחה, צריך להשתמש בבקשת ה-HTTP הבאה מסוג GET
ולכלול את אסימון ההרשאה.
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=PREFIX &pageToken=TOKEN&maxResults=MAX_NUMBER
מחליפים את מה שכתוב בשדות הבאים:
PREFIX
: ההתחלה של שם הלקוח שאת המינויים שלו אתם מחפשים.TOKEN
: אסימון שמזהה דף ספציפי של תוצאות שהשרת צריך להציג.MAX_NUMBER
: מספר התוצאות המקסימלי שמוחזר בדף התגובה.
אפשר להשתמש בהרשאת הגישה לקריאה בלבד של OAuth בפעולה הזו. הערכים customerNamePrefix
, pageToken
ו-maxResults
הם מחרוזות שאילתה אופציונליות.
בדוגמה הבאה מתבצעת אחזור של כל המינויים של מפיץ ששייכים ללקוחות שהשם שלהם מתחיל ב-'exam':
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=exam
{
"kind": "reseller#subscriptions",
"subscriptions": [
{
"kind": "subscriptions#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"creationTime": "1331647980142",
"billingMethod": "ONLINE",
"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": "PO_135",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
},
{
"kind": "subscriptions#subscription",
"customerId": "custId-5678",
"subscriptionId": "1404686",
"skuId": "1010020028",
"billingMethod": "ONLINE",
"creationTime": "1329389322728",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 50,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false,
"trialEndTime": "1331877480016"
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "AUTO_RENEW"
},
"purchaseOrderId": "",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
},
],
"nextPageToken": "token"
}
עדכון תוכנית מינוי
האופן שבו מעדכנים תוכניות ב-Google Workspace משתנה בהתאם לתוכנית. לפני שמעדכנים תוכנית, כדאי להביא בחשבון את הנקודות הבאות:
כשיוצרים מינוי והלקוח עומד בדרישות, אפשר להגדיר לתוכנית המינוי תקופת ניסיון של 30 יום. גם בתוכניות התמחור והתשלומים הגמישות וגם בתוכניות התמחור והתשלומים עם התחייבות שנתית יש תקופת ניסיון בחינם של 30 יום. במהלך תקופת הניסיון, תוכלו לשנות את תוכנית התשלומים של המינוי לתוכנית התחייבות גמישה או לתוכנית התחייבות שנתית, כמה פעמים שתרצו. עם זאת, אחרי שתקופת הניסיון מסתיימת והתוכנית הופכת לפעילה, העדכון שלה מתבצע לפי אותם כללים שחלים על תוכניות פעילות של מינויים אחרים. כדי להעביר מינוי לתקופת ניסיון למינוי פעיל באופן מיידי, מתחילים את השירות בתשלום ממינוי לתקופת ניסיון בחינם של 30 יום. מידע נוסף על תקופת הניסיון של 30 יום ועל כללי הזכאות של הלקוחות זמין במרכז העזרה לניהול.
אפשר לעדכן תוכנית גמישה לתוכנית התמחור והתשלומים עם התחייבות שנתית.
לא ניתן לעדכן תוכנית מחויבות שנתית.
לא כל התוכניות פועלות עם כל המוצרים. מידע נוסף על המוצרים שבהם נעשה שימוש בתוכניות האלה זמין במאמר מוצרים ומק "טים.
כדי לעדכן תוכנית של תקופת ניסיון של 30 יום או מינוי לתוכנית גמישה לתוכנית התחייבות שנתית, משתמשים בבקשת ה-HTTP POST
הבאה:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changePlan
מחליפים את מה שכתוב בשדות הבאים:
CUSTOMER_ID
: שם הדומיין הראשי של הלקוח או המזהה הייחודי שלו.SUBSCRIPTION_ID
: מזהה המינוי, שהוא ייחודי לכל לקוח. אפשר לאחזר את הערך הזה באמצעות השיטה Retrieve all reseller subscriptions.
בדוגמה הבאה מתבצע עדכון של המינוי עם הערך 123 בשדה subscriptionId
. הערך של customerId
הוא C0123456.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changePlan
גוף הבקשה כולל את הפרטים הבאים:
{
"kind": "reseller#changePlanRequest",
"planName": "ANNUAL_MONTHLY_PAY",
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10
},
"purchaseOrderId": "123_March2012"
}
בתגובה מוצלחת מוחזר קוד סטטוס HTTP 201
והגדרות תוכנית המינוי המעודכנות:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"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": "123_March2012",
"status": "ACTIVE",
"skuName": "Google Workspace Business Standard"
}
עדכון מספר המושבים במינוי
כשמעדכנים מינוי לתוכנית התחייבות שנתית, משתמשים במאפייני מינוי שונים מאשר כשמעדכנים מינוי לתוכנית גמישה של Google Workspace.
עדכון מספר המושבים במינוי שנתי
כדי לעדכן את הגדרות הרישיון של משתמש במינוי לתוכנית שנתית, משתמשים בבקשת ה-HTTP הבאה של POST
:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeSeats
מחליפים את מה שכתוב בשדות הבאים:
CUSTOMER_ID
: שם הדומיין הראשי של הלקוח או המזהה הייחודי שלו.SUBSCRIPTION_ID
: מזהה המינוי, שהוא ייחודי לכל לקוח. אפשר לאחזר את הערך הזה באמצעות השיטה Retrieve all reseller subscriptions.
בדוגמה הבאה מתבצע עדכון של המינוי באמצעות subscriptionId
של 123. הערך של customerId
הוא C0123456. גוף הבקשה משתנה בהתאם לסוג התוכנית:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changeSeats
גוף הבקשה הזה משמש לעדכון מספר הרישיונות של משתמשים במינוי לתוכנית התחייבות שנתית ל-Google Workspace. הערך של numberOfSeats
הוא סכום כולל. לדוגמה, אם היו לכם בעבר 10 רישיונות משתמשים וקיבלתם הזמנה מלקוח ל-5 רישיונות חדשים, המספר הכולל בגוף הבקשה עבור numberOfSeats
הוא 15, כפי שמוצג בדוגמה הבאה:
{
"kind": "subscriptions#seats",
"numberOfSeats": 15
}
עדכון מספר המושבים במינוי לתוכנית גמישה
המינוי לתוכנית הגמישה של Google Workspace משתמש בגוף הבקשה כדי לעדכן את רשיונות המשתמשים. הערך של maximumNumberOfSeats
הוא הסכום הכולל של הרישיונות הקיימים והרישיונות החדשים. זהו המספר המקסימלי של רישיונות משתמשים שאפשר להקצות בחשבון.
{
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 15
}
בתגובה מוצלחת מוחזר קוד סטטוס HTTP 201
והגדרות הרישיון המעודכנות של המינוי:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 15,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"skuName": "Google Workspace Business Standard"
}
עדכון הגדרות החידוש של מינוי
כדי לעדכן את הגדרות החידוש של מינוי עם התחייבות שנתית, משתמשים בבקשת ה-HTTP הבאה של POST
:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeRenewalSettings
מחליפים את מה שכתוב בשדות הבאים:
CUSTOMER_ID
: שם הדומיין הראשי של הלקוח או המזהה הייחודי שלו.SUBSCRIPTION_ID
: מזהה המינוי, שהוא ייחודי לכל לקוח. אפשר לאחזר את הערך הזה באמצעות השיטה Retrieve all reseller subscriptions.
דוגמה לגוף בקשה:
{
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
}
הערך של המאפיין renewalType
יכול להיות כל אחד מהערכים הבאים:
AUTO_RENEW_YEARLY_PAY
: בסיום התקופה של תוכנית ההתחייבות השנתית, מתחדשת באופן אוטומטי תוכנית המינוי כ-ANNUAL_YEARLY_PAY
עם אותוnumberOfSeats
.AUTO_RENEW_MONTHLY_PAY
: בסיום התקופה של תוכנית ההתחייבות השנתית, מתבצע חידוש אוטומטי של תוכנית המינוי כ-ANNUAL_MONTHLY_PAY
עם אותוnumberOfSeats
.RENEW_CURRENT_USERS_YEARLY_PAY
: בסוף התקופה של תוכנית ההתחייבות השנתית, מחדשים את תוכנית המינוי כ-ANNUAL_YEARLY_PAY
, אבל משתמשים במספר הכולל של הרישיונות הנוכחיים של המשתמשים הפעילים. זוהי הגדרת ברירת המחדל לתוכניות התחייבות שנתיות פעילות (בתשלום שנתי).RENEW_CURRENT_USERS_MONTHLY_PAY
: בסוף התקופה של תוכנית ההתחייבות השנתית, מחדשים את תוכנית המינוי כ-ANNUAL_MONTHLY_PAY
, אבל משתמשים במספר הכולל של הרישיונות הנוכחיים של המשתמשים הפעילים. זוהי הגדרת ברירת המחדל לתוכניות התחייבות שנתיות פעילות (בתשלום חודשי).RENEW_ON_PROPOSED_OFFER
: בסוף התקופה של תוכנית ההתחייבות הנוכחית, החידוש יתבצע לפי הצעת החידוש האחרונה, כאשר numberOfSeats יהיה מספר הרישיונות הקיימים של המשתמשים הפעילים או מספר ההתחייבויות בהצעה, לפי הערך הגבוה מביניהם.SWITCH_TO_PAY_AS_YOU_GO
: בסוף התקופה של התוכנית עם ההתחייבות השנתית, מחליפים את התוכנית עם ההתחייבות השנתית לתוכנית גמישה.CANCEL
: בסיום מרווח הזמן של תוכנית ההתחייבות השנתית, המינוי מושעה. במאמר במרכז העזרה לניהול מוסבר איך מבטלים השעיה.
בתשובה מוצלחת מופיע קוד הסטטוס 201
של HTTP והגדרות החידוש המעודכנות של המינוי:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 15,
"licensedNumberOfSeats": 15
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"skuName": "Google Workspace Business Standard"
}
התחלת השימוש בשירות בתשלום ממינוי לתקופת ניסיון בחינם
כדי להעביר מינוי לתקופת ניסיון בחינם של 30 יום למינוי לשירות בתשלום באופן מיידי, אם כבר הגדרתם תוכנית תשלומים למינוי לתקופת הניסיון, צריך להשתמש בבקשת ה-HTTP הבאה מסוג POST
.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/startPaidService
מחליפים את מה שכתוב בשדות הבאים:
CUSTOMER_ID
: שם הדומיין הראשי של הלקוח או המזהה הייחודי שלו.SUBSCRIPTION_ID
: מזהה המינוי, שהוא ייחודי לכל לקוח. אפשר לאחזר את הערך הזה באמצעות השיטה Retrieve all reseller subscriptions.
בדוגמה הבאה, הערך של customerId
הוא C0123456 והערך של subscriptionId
הוא 123:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/startPaidService
לפעולה הזו אין פרמטרים בגוף הבקשה.
בתגובה מוצלחת מוחזר קוד סטטוס HTTP 201
והגדרות המינוי המעודכנות:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 15,
"licensedNumberOfSeats": 15
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"skuName": "Google Workspace Business Standard"
}
שדרוג או שדרוג לאחור של מינוי
אי אפשר לשדרג לאחור תוכניות שנתיות באמצע תקופת המינוי, ואי אפשר לתזמן שדרוג לאחור באמצעות הגדרות החידוש. מומלץ להגדיר את ההגדרות של חידוש הרישיון כך שיעברו ל-FLEXIBLE
, ואז לשדרג לאחור אחרי מועד החידוש.
כדי לשדרג או לשדרג לאחור מינוי, יוצרים מינוי חדש עם skuId
שרוצים לשדרג אליו או לשדרג לאחור אליו.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
מחליפים את מה שכתוב בשדות הבאים:
CUSTOMER_ID
: שם הדומיין הראשי של הלקוח או המזהה הייחודי שלו.
הקריאה הזו מבטלת את המינוי הקודם ויוצרת מינוי חדש.
מידע נוסף על שדרוגים וירידות בדרגה זמין בדף 'מוצרים ומק"טים'.