ניהול זכויות גישה למבצעים פרטיים

כשלקוח רוכש מבצע פרטי, Google יוצרת הרשאה שמציינת שהלקוח רכש את המבצע מ-Cloud Marketplace.

במאמר הזה מוסבר איך לנהל את ההרשאות של המבצעים הפרטיים באמצעות Producer Portal ו-Partner Procurement API. כדי לאשר את הרשאות הגישה של המבצע, אתם יכולים להשתמש ב-Producer Portal או ב-Partner Procurement API. כדי לבצע משימות אחרות שקשורות לניהול הרשאות להצעות, צריך להשתמש ב-Partner Procurement API.

אישור הרשאות באמצעות Producer Portal

אתם יכולים להשתמש ב-Producer Portal כדי לאשר הרשאות למבצעים פרטיים עם הסטטוס Needs your approval. כדי לאשר הרשאה:

  1. ב-Producer Portal, נכנסים לדף Private Offers.

  2. במבצע שרוצים לאשר, לוחצים על ניהול המבצעים ואז על אישור.

  3. בתיבת הדו-שיח Approve offer, מסמנים את התיבה I have done everything I need to do on my end for this customer to use my product ולוחצים על Approve.

ניהול הרשאות באמצעות Partner Procurement API

בקטעים הבאים מוסבר איך לנהל את ההרשאות למבצעים פרטיים באמצעות Partner Procurement API.

במאמרי העזרה מוסבר איך משתמשים ב-Partner Procurement API בשביל מבצעים פרטיים.

אישור הרשאה

כשלקוח רוכש מבצע פרטי, Cloud Marketplace יוצר הרשאה ושולח את ההודעה הבאה ב-Pub/Sub למוצר שלכם:

{
  "eventId": "...",
  "eventType": "ENTITLEMENT_CREATION_REQUESTED",
  "entitlement": {
  "id": "ENTITLEMENT_ID",
  "updateTime": "...",
  "newPendingOfferDuration": "P1Y6M", // Contract duration for the offer
  "newOfferEndTime": "", // Ending time for the offer
  },
}

בדוגמה הזו, ENTITLEMENT_ID הוא מזהה שנוצר על ידי Cloud Marketplace.

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

במערכת שלכם, מעדכנים את החשבון של המשתמש כדי לציין שהוא רכש את המבצע. כדי לאשר את ההרשאה, שולחים בקשת HTTP POST ל-Partner Procurement API, ומציינים את ה-ENTITLEMENT_ID שמאשרים:

POST v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID:approve

דחיית הרשאה

כדי לדחות הרשאה, משתמשים ב-method‏ reject בבקשת HTTP POST:

POST v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID:reject

החלפת מבצע פעיל

בהתאם לאופן שבו הגדרתם את המבצע הפרטי, יכול להיות שהלקוח יוכל להחליף את המבצע. אם לקוח בוחר מבצע פרטי חדש, אתם מקבלים הודעת Pub/Sub בפורמט הבא:

{
  "eventId": "...",
  "eventType": "ENTITLEMENT_PLAN_CHANGE_REQUESTED",
  "entitlement": {
  "id": "ENTITLEMENT_ID",
  "newPendingPlan": "ultimate",   // New plan for the offer,
  "newPendingOffer": "OFFER2",    // New offer,
  "updateTime": "...",
  "newPendingOfferDuration": "P2Y",   // Contract duration for the new offer
  },
}

בדוגמה הזו, OFFER2 הוא המבצע החלופי ו-ENTITLEMENT_ID הוא מזהה שנוצר על ידי Cloud Marketplace. משך המבצע מצוין בשנים ובחודשים.

כדי לאשר את החלפת המבצע, שולחים את הבקשה הבאה של HTTP POST ל-Partner Procurement API:

POST v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID:approvePlanChange

גוף הבקשה חייב לכלול את התוכנית של המבצע שמאושר:

{
  "pendingPlanName": PLAN_NAME
}

אחרי שהשינוי יאושר, תקבלו הודעת Pub/Sub נוספת כשהשינוי ייכנס לתוקף. בהודעה, השדה eventType משתנה ל-ENTITLEMENT_PLAN_CHANGED. כדי לבדוק את הסטטוס של תוכנית, שולחים את בקשת ה-HTTP GET הבאה ל-Partner Procurement API:

GET v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID

התגובה אמורה להיראות כך, והשדה state מציין אם המבצע החדש פעיל או אם השינוי במבצע עדיין בהמתנה:

{
  "name": "providers/PARTNER_ID/entitlements/ENTITLEMENT_ID",
  "provider": "PARTNER_ID",
  "account": "USER_ACCOUNT_ID",
  "product": "example-server",
  "Offer":   "OFFER1",
  "plan": "pro",
  "state": "ENTITLEMENT_PENDING_PLAN_CHANGE",
  "newPendingOffer": "OFFER2",
  "newPendingPlan": "ultimate",
  "newPendingOfferDuration": "P2Y",
  "newOfferEndTime": "",
  ...
}

ביצוע משימות אחרות שקשורות להרשאות

למשימות אחרות שקשורות להרשאות ולא ספציפיות למבצעים פרטיים, עיינו במסמכי התיעוד הציבוריים של Cloud Marketplace:

רשימה של סוגי אירועים למשימות בחשבון של מבצע פרטי

בטבלה הבאה מפורטים ערכי eventType שהמוצר שלכם עשוי לקבל בהודעות Pub/Sub לגבי מבצעים פרטיים.

רשימה מלאה של סוגי אירועים למשימות בחשבון

eventType תיאור
ENTITLEMENT_OFFER_ENDED מציין שהמבצע הפרטי של הלקוח הסתיים. ההצעה מפעילה אירוע ENTITLEMENT_CANCELLED או נשארת פעילה עם מחיר ללא הנחה.

המאמרים הבאים