ניהול זכויות גישה ל-Google Workspace ול-Google Chrome

בדף הזה מוסבר איך לנהל את ההרשאות של לקוחות למוצרי Google Workspace ו-Google Chrome.

דרישה מוקדמת

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

יצירת הרשאה

לפני שמתחילים

כדי להמשיך, צריך להגדיר Customer.

כדי ליצור הרשאה, מבצעים את השלבים הבאים:

  1. עם שם הלקוח, תתקשר אל listPurchasableSkus כדי לאחזר רשימה של PurchasableSkus

    ListPurchasableSkusRequest
{
  "customer": "accounts/123/customers/abc",
  "createEntitlementPurchase": {
    "product": "products/-"
  }
}
ListPurchasableSkusResponse
{
  "purchasableSkus": [
    {
      "sku": {
        "name": "products/product_id/skus/sku_id1",
        "product": {
          "name": "products/product_id",
        }
      }
    },
    {
      "sku": {
        "name": "products/product_id/skus/sku_id2",
        "product": {
          "name": "products/product_id",
        },
      }
    }
  ]
}

  2. אחרי שבוחרים את ה-PurchasableSku, משתמשים בשיטה queryEligibleBillingAccounts כדי למצוא קבוצה של BillingAccount של Google Workspace שאפשר להשתמש בהם כדי לשלם על ההרשאה.

    1. אם אתם רוצים לשלם במטבע מסוים, אתם צריכים לבחור BillingAccount עם המטבע הזה.
    QueryEligibleBillingAccountsRequest
{
  "customer": "accounts/123/customers/abc",
  "skus": ["products/product_id/skus/sku_id1"]
}
QueryEligibleBillingAccountsResponse
{
  "skuPurchaseGroups": [
    {
      "skus": [
        "products/product_id/skus/sku_id1"
      ],
      "billingAccountPurchaseInfos": [
        {
          "billingAccount": {
            "name": "accounts/123/billingAccounts/billing_account_id1",
            "displayName": "Google_Workspace_USD_US_1",
            "currencyCode": "USD",
            "regionCode": "US"
          }
        },
        {
          "billingAccount": {
            "name": "accounts/123/billingAccounts/billing_account_id2",
            "displayName": "Google_Workspace_CAD_CA_1",
            "currencyCode": "CAD",
            "regionCode": "CA"
          }
        }
      ]
    }
  ]
}

  3. אחרי שבוחרים את PurchasableSku ואת BillingAccount, משתמשים בשיטה listPurchasableOffers כדי למצוא את PurchasableOffer הזמין.

    ListPurchasableOffersRequest
{
  "customer": "accounts/123/customers/abc",
  "createEntitlementPurchase": {
    "sku": "products/product_id/skus/sku_id1",
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
ListPurchasableOffersResponse
{
  "purchasableOffers": [
    {
      "offer": {
        "name": "accounts/123/offers/offer_id1",
      },
      "sku": {
        "name": "products/product_id/skus/sku_id1",
      },
      "plan": {
        "paymentPlan": "FLEXIBLE",
        "paymentCycle": {
          "duration": 1,
          "periodType": "MONTH"
        }
      },
      "priceReferenceId": "price_reference_id_123"
    }
  ],
}

  4. בשלב הזה אמור להיות לכם BillingAccount שישמש לתשלום עבור Entitlement ו-PurchasableOffer. מתחילים ליצור את ההרשאה באמצעות השיטה create.

    1. יוצרים הרשאה וממלאים את הפרטים של המבצע, billingAccount וכל פרמטר נדרש אחר. אם מזהה ההפניה של המחיר מופיע ב-PurchasableOffer, צריך לאכלס אותו ב-entitlement כדי לוודא שהמחיר שצוין למעלה יופיע ב-entitlement החדש. בלי מזהה הפניה למחיר, אין ערובה לכך שההנחה והמחיר בפועל שיוחזרו מה-ListPurchasableOffersResponse יהיו זהים בקריאה הזו של CreateEntitlement. הוספת מזהה הפניה למחיר מבטיחה התאמה במחיר בזכות הזכאות החדשה הזו.
    CreateEntitlementRequest
{
  "parent": "accounts/123/customers/abc",
  "entitlement": {
    "offer": "accounts/123/offers/offer_id1",
    "maxUnits": 100,
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2",
    "priceReferenceId": "price_reference_id_123"
  }
}
CreateEntitlementResponse
{
  "name": "operations/operation_id1"
}

שינוי תוכנית התשלומים בהרשאות ל-Google Workspace

לפני שמתחילים

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

כדי לשנות את תוכנית התשלומים בהרשאות ל-Google Workspace, צריך לבצע את השלבים הבאים:

שני השלבים הראשונים נדרשים רק אם לזכאות הקיימת יש תוכנית תשלומים מסוג Free או Trial.

  1. במסגרת המבצע, אפשר להשתמש בשיטה lookupOffer כדי למצוא מידע על Sku במסגרת המבצע.

    LookupOfferRequest
{
  "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1"
}
LookupOffer respones
{
  "name": "accounts/123/offers/offer_id1",
  "sku": {
    "name": "products/product_id/skus/sku_id1",
   }
}

  2. בעזרת הלקוח ומק"ט, משתמשים בשיטה queryEligibleBillingAccounts כדי למצוא קבוצה של BillingAccount שאפשר להשתמש בה כדי לשלם על ה-Entitlement הזה. אם רוצים לשלם במטבע ספציפי, צריך לבחור BillingAccount עם המטבע הזה.

     QueryEligibleBillingAccountsRequest
 {
   "customer": "accounts/123/customers/abc",
   "skus": ["products/product_id/skus/sku_id1"]
 }
 QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

  3. בעזרת ה-Entitlement וה-BillingAccount, אפשר להשתמש בשיטה listPurchasableOffers כדי למצוא כל PurchasableOffer. אין צורך ב-BillingAccount אם לזכאות הקיימת כבר יש תוכנית בתשלום. במקרה כזה, ייעשה שימוש ב-BillingAccount הקיים. כדי לשנות את תוכנית התשלומים, צריך להגדיר את השדה purchase_option לערך changeOfferPurchase

    ListPurchasableOffersRequest
{
  "customer": "accounts/123/customers/abc",
  "changeOfferPurchase": {
    "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
ListPurchasableOffersResponse
{
  "purchasableOffers": [
    {
      "offer": {
        "name": "accounts/123/offers/offer_id1",
      },
      "sku": {
        "name": "products/product_id/skus/sku_id1",
      },
      "plan": {
        "paymentPlan": "FLEXIBLE",
        "paymentCycle": {
          "duration": 1,
          "periodType": "MONTH"
        }
      },
      "priceReferenceId": "price_reference_id_123"
    }
  ],
}

  4. בשלב הזה אמורים להיות לכם הרשאות, מבצע וחשבון לחיוב. כדי לשנות את תוכנית התשלומים, משתמשים בשיטה changeOffer. אם יש מזהה הפניה למחיר ב-PurchasableOffer, צריך לאכלס אותו בהרשאה כדי לוודא שההרשאה החדשה תכלול את המחיר שצוין למעלה. בלי מזהה הפניה למחיר, אין ערובה לכך שההנחה והמחיר בפועל שיוחזרו מה-ListPurchasableOffersResponse יהיו זהים בקריאה הזו של ChangeOffer. הזנת מזהה הפניה למחיר הזה מבטיחה התאמה בין המחירים בהרשאה החדשה הזו.

    ChangeOfferRequest
{
  "name": "accounts/abc/customers/123/entitlements/entitlement_id1",
  "offer": "accounts/abc/offers/offer_id1",
  "billing_account": "accounts/abc/billingAccounts/billing_account_id2",
  "parameters": [{
    "name": "max_units",
    "value": {
      "int64Value": "100"
    }
  }],
  "priceReferenceId": "price_reference_id_123"
}
ChangeOfferResponse
{
  "name": "operations/operation_id1"
}

שדרוג או שדרוג לאחור של הרשאות ב-Google Workspace

כדי לשדרג או לשדרג לאחור את ההרשאות ב-Google Workspace, פועלים לפי השלבים הבאים:

  1. בעזרת הזכאות, מפעילים את השיטה listPurchasableSkus כדי לאחזר רשימה של מק"טים לרכישה שאפשר להשתמש בהם לשדרוג או לשדרוג לאחור.

    ListPurchasableSkusRequest
{
  "customer": "accounts/123/customers/abc",
  "changeOfferPurchase": {
    "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
    "changeType": "UPGRADE"
  }
}
ListPurchasableSkusResponse
{
  "purchasableSkus": [
    {
      "sku": {
        "name": "products/product_id/skus/sku_id1",
        "product": {
          "name": "products/product_id",
        }
      }
    },
    {
      "sku": {
        "name": "products/product_id/skus/sku_id2",
        "product": {
          "name": "products/product_id",
        },
      }
    }
  ]
}

  2. ב-PurchasableSku, משתמשים בשיטה queryEligibleBillingAccounts כדי למצוא קבוצה של BillingAccounts שאפשר להשתמש בהם כדי לשלם על ה-Entitlement.

    1. אם אתם רוצים לשלם במטבע מסוים, אתם צריכים לבחור BillingAccount עם המטבע הזה.
     QueryEligibleBillingAccountsRequest
 {
   "customer": "accounts/123/customers/abc",
   "skus": ["products/product_id/skus/sku_id1"]
 }
 QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

  3. בעזרת ה-Entitlement וה-BillingAccount, משתמשים בשיטה listPurchasableOffers כדי למצוא כל PurchasableOffer.

      ListPurchasableOffersRequest
  {
    "customer": "accounts/123/customers/abc",
    "changeOfferPurchase": {
      "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
      "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
    }
  }
  ListPurchasableOffersResponse
  {
    "purchasableOffers": [
      {
        "offer": {
          "name": "accounts/123/offers/offer_id1",
        },
        "sku": {
          "name": "products/product_id/skus/sku_id1",
        },
        "plan": {
          "paymentPlan": "FLEXIBLE",
          "paymentCycle": {
            "duration": 1,
            "periodType": "MONTH"
          }
        },
        "priceReferenceId": "price_reference_id_123"
      }
    ],
  }
  ```

  4. בשלב הזה אמורים להיות לכם Entitlement, ‏ PurchasableOffer ו-BillingAccount. מתחילים לשדרג או לשנמך באמצעות השיטה changeOffer.

    1. יוצרים אובייקט Entitlement וממלאים את הפרמטרים name, ‏ offer, ‏ billingAccount וכל פרמטר נדרש אחר. אם מזהה ההפניה של המחיר מופיע ב-PurchasableOffer, צריך לאכלס אותו ב-entitlement כדי לוודא שהמחיר שצוין למעלה יופיע ב-entitlement החדש. בלי מזהה הפניה למחיר, אין ערובה לכך שההנחה והמחיר האפקטיבי שיוחזרו מה-ListPurchasableOffersResponse יהיו זהים בקריאה הזו ל-ChangeOffer. אם תמלאו את מזהה ההפניה למחיר, תהיה התאמה בין המחירים בהרשאה החדשה הזו.
       ChangeOfferRequest
   {
     "name": "accounts/abc/customers/123/entitlements/entitlement_id1",
     "offer": "accounts/abc/offers/offer_id1",
     "billing_account": "accounts/abc/billingAccounts/billing_account_id2",
     "parameters": [{
       "name": "max_units",
       "value": {
         "int64Value": "100"
       }
     }],
     "priceReferenceId": "price_reference_id_123"
   }
   ChangeOfferResponse
   {
     "name": "operations/operation_id1"
   }
   ```

העברת הרשאות

בקטע הזה מוסבר איך להעביר זכויות של לקוחות קיימים של Google Workspace ו-Chrome מהשותף הקודם שלהם.

במדריכים שלנו מוסבר איך להעביר לקוחות במסוף Partner Sales אל חשבון שותף או אל חשבון Google.

לקוחות Google Workspace יכולים לרכוש הרשאות רק משותף אחד או משותף אחד ומ-Google.

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

לפני שמתחילים

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

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

כדי להעביר זכויות שימוש, פועלים לפי השלבים הבאים:

אם יש לכם רק את הדומיין של הלקוח, אתם יכולים להשתמש ב-Cloud Channel API כדי לקבל את מזהה Cloud Identity שלו. קוראים ל-API‏ checkCloudIdentityAccountsExist עם הדומיין של הלקוח, ואם הדומיין קיים, ה-API יחזיר את מזהה Cloud Identity של הלקוח.

  1. מתחילים את ההעברה באמצעות השיטה customers.import לייבוא נתוני הלקוח.

    ImportCustomerRequest
{
  "parent": "accounts/abc",
  "domain": "domain"
}

  2. בעזרת מזהה ה-Cloud Identity של הלקוח, קוראים ל-listTransferableSkus כדי לאחזר רשימה של transferableSku של הלקוח. בודקים את transferEligibility של כל אובייקט כדי לוודא שאפשר לרכוש את המק"ט המשויך.

    ListTransferableSkusRequest
{
  "parent": "accounts/abc",
  "cloudIdentityId": "cloud_identity_id"
}
ListTransferableSkusResponse
{
  "transferableSku": [
    {
      "sku": {
           "name": "products/product_id/skus/voice_sku_id1",
      },
    },
    {
      "sku": {
           "name": "products/product_id/skus/google_workspace_sku_id2",
      },
    },
    {
      "sku": {
           "name": "products/product_id/skus/google_workspace_chrome_sku_id3",
      },
    }
  ],
}

  3. אחרי שיש לכם רשימה של TransferableSkus, צריך לקבוע איזה BillingAccount ישמש לתשלום על ההרשאות. אפשר להשתמש בשיטה queryEligibleBillingAccounts כדי למצוא קבוצה של BillingAccount שאפשר להשתמש בה לכל TransferableSku.

    1. שימו לב: חלק מ-TransferableSkus צריכים להיות באותו חשבון לחיוב ב-Google Workspace. לכן, queryEligibleBillingAccounts מחזירה קבוצת מק"טים שמציינת אילו TransferableSkus צריכים להיות באותו BillingAccount. אם יש כמה חשבונות לחיוב ב-Google Workspace עבור קבוצת SKU מסוימת, אפשר לבחור אחד מהם ולהשתמש בו לכל TransferableSku בקבוצה.
    QueryEligibleBillingAccountsRequest
{
  "customer": "accounts/123/customers/abc",
  "skus": ["products/product_id/skus/voice_sku_id1","products/product_id/skus/google_workspace_sku_id2","google_workspace_chrome_sku_id3"]
}
QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/voice_sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/voice_billing_account_id1",
             "displayName": "Google_Workspace_Voice_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         }
       ]
     },
     {
       "skus": [
         "products/product_id/skus/google_workspace_sku_id2","google_workspace_chrome_sku_id3"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/gw_billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/gw_billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

  4. לכל זוג של TransferableSku ו-BillingAccount, משתמשים בשיטה listTransferableOffers כדי למצוא TransferableOffers זמינים. בשלב הזה אמורה להיות לכם רשימה של טאפלים של הלקוח שכוללת את TransferableSku,‏ BillingAccounts ו-TransferableOffer.

    ListTransferableOffersRequest
{
  "parent": "accounts/abc",
  "cloudIdentityId": "cloud_identity_id",
  "sku": "products/product_id/skus/voice_sku_id1",
  "billingAccount": "ccounts/123/billingAccounts/voice_billing_account_id1"
}
ListTransferableOffersResponse
   {
     "transferableOffers": [
       {
         "offer": {
           "name": "accounts/123/offers/voice_offer_id1",
         },
         "sku": {
           "name": "products/product_id/skus/voice_sku_id1",
         },
         "plan": {
           "paymentPlan": "FLEXIBLE",
           "paymentCycle": {
             "duration": 1,
             "periodType": "MONTH"
           }
         },
         "priceReferenceId": "price_reference_id_voice_offer_12"
       }
     ],
   }

  5. לכל טופל יוצרים אובייקט Entitlement חדש תואם. לכל אובייקט Entitlement צריך להיות Offer,‏ BillingAccount וכל הפרמטרים הנדרשים. אם מזהה הפניה למחיר מופיע ב-PurchasableOffer, צריך לאכלס אותו בזכאות כדי לוודא שהמחיר שצוין למעלה יופיע בזכאות החדשה. בלי מזהה הפניה למחיר, אין ערובה לכך שההנחה והמחיר בפועל שיוחזרו מהקריאה ListPurchasableOffersResponse יהיו זהים בקריאה הזו של TransferEntitlements. הוספת מזהה הפניה למחיר מבטיחה שהמחיר יתאים לזכאות החדשה הזו. כדי לבצע את ההעברה, צריך להפעיל את ה-method‏ transferEntitlements.

    TransferEntitlementsRequest
{
  "parent": "accounts/abc/customers/123",
  "entitlements": [
    { 
      "offer": "accounts/123/offers/voice_offer_id1",
      "maxUnits": 100,
      "billingAccount": "accounts/123/billingAccounts/voice_billing_account_id1",
      "priceReferenceId": "price_reference_id_voice_offer_12"
    },
    {
      "offer": "accounts/123/offers/gw_offer_id2",
      "maxUnits": 150,
      "billingAccount": "accounts/123/billingAccounts/gw_billing_account_id1"
    }
    {
      "offer": "accounts/123/offers/gw_chrome_offer_id3",
      "maxUnits": 200,
      "billingAccount": "accounts/123/billingAccounts/gw_billing_account_id1",
      "priceReferenceId": "price_reference_id_chrome_offer_34"
    }   
  ]
}
TransferEntitlementsResponse
{
  "name": "operations/operation_id1"
}