با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یکی از راههایی که Google خدمات محصول Google را به کاربران ارائه میکند، از طریق کانالهای توزیع خدمات مانند نمایندگیهای مجاز Google Workspace است. هنگام کار با Reseller API، درک روابط مفهومی فروشندگان با مشتریان، برنامه های پرداخت، SKUهای محصول و مجوزها بسیار مهم است.
نمایندگی فروش
یک فروشنده مجوزهای کاربر را از Google خریداری می کند و این مجوزها را به مشتریان Google می فروشد. یک فروشنده می تواند اشتراک مشتریان را مستقیماً مدیریت کند، یا در صورت سفارشی سازی چندین سرویس، یک فروشنده می تواند با یکپارچه ساز خدمات برای مدیریت مشتریان کار کند.
فروشندگان می توانند از طرح های زیر انتخاب کنند:
تعهد سالانه: فروشنده مقدار ثابتی از مجوزها را به مدت یک سال از Google خریداری می کند. مشتریان میتوانند حداکثر تعداد مجوزها را ایجاد کنند، اما تعداد مجوزهای سفارش داده شده از فروشندگان صورتحساب دریافت میشود. اگر مشتریان به مجوزهای اضافی نیاز دارند، فروشندگان می توانند از تماس API subscriptions.changeSeats برای افزایش تعداد مجوزهای سفارش داده شده استفاده کنند.
انعطاف پذیر: هر بار که مشتری کاربر جدیدی ایجاد می کند، Google برای این مجوز از فروشنده هزینه می گیرد. قرارداد فروشنده با Google قیمت، مشخصات و حداکثر تعداد مجوزها را شرح می دهد.
همراه با مدیریت مجوزهای کاربر، فروشنده (یا یکپارچهسازهای خدمات شریک آن) طیف گستردهای از خدمات اضافی مانند آموزش، تبلیغات، تبلیغات، قیمتگذاری، سفارشیسازیهای استقرار، عیبیابی و نگهداری را به مشتریان ارائه میدهد.
مجوزها
مجوز به کاربر با حساب Google امکان دسترسی به خدمات Google Workspace را می دهد. وقتی مشتری مجوزی را به کاربر اختصاص می دهد، به یک مجوز فعال تبدیل می شود. تنها مجوزهای فعال هنگام محاسبه تعداد کل کاربران یک مشتری محاسبه می شوند.
مشتری
یک مشتری Google با یک حساب Google Workspace شروع می کند که فروشنده آن را پیکربندی می کند. هنگام تنظیم حساب مشتری، فروشنده یک نام دامنه اصلی، ایمیل جایگزین و یک آدرس فیزیکی ارائه می دهد. سپس، فروشنده همچنین برای هر SKU محصولی که در دسترس مشتری است، اشتراک ایجاد می کند. مشتری میزبان هر حساب کاربری جداگانه است. برای اطلاعات بیشتر، به سفارش یک حساب مشتری جدید مراجعه کنید.
طرح ها
یک طرح شرایط صورتحساب فروشنده را با Google تعریف میکند. این طرح ها رابطه صورتحساب بین فروشنده و مشتریانش را تعریف نمی کنند. فروشندگان شرایط صورتحساب خود را با مشتریان خود تعریف می کنند.
Reseller API از سیستم پسپرداخت ماهانه Google Workspace پشتیبانی میکند که چندین طرح پرداخت در دسترس دارد:
ANNUAL_MONTHLY_PAY : تعهد سالانه با پرداخت های ماهانه
ANNUAL_YEARLY_PAY : تعهد سالانه با یک پرداخت سالانه
FLEXIBLE : طرح بدون تعهد با پرداخت ماهانه
TRIAL : طرح آزمایشی رایگان
طول دوره آزمایشی تا حداکثر 30 روز متغیر است.
محدودیت ارسال روزانه Gmail 500 پیام برای هر کاربر.
FREE : طرح رایگان فقط برای اشتراک نسخه رایگان Cloud Identity
یک اشتراک، رابطه طرح پرداخت مشتری Google با SKU محصول، مجوزهای کاربر، وضعیت آزمایشی رایگان 30 روزه و گزینههای تمدید را مدیریت میکند. نقش اصلی یک فروشنده این است که اشتراک های مشتری Google را مدیریت کند.
در Reseller API، اشتراک یک منبع API اصلی است. تنظیمات طرح پرداخت، مجوزها، آزمایش رایگان 30 روزه، تمدید و سفارش خرید فروشنده را تعریف می کند. یک مشتری می تواند بیش از یک اشتراک داشته باشد، یکی برای هر SKU محصولی که فروشنده به مشتری اختصاص می دهد.
هر اشتراک یک شناسه منحصر به فرد دارد، یک subscriptionId . از آنجایی که با تغییر اشتراک، یک subscriptionId تغییر میکند، از مقدار subscriptionId به عنوان کلید دادههای دائمی استفاده نکنید. در صورت تغییر اشتراک، این کلید خراب می شود.
یک محصول یک پیشنهاد تجاری از مجموعه تخصصی خدمات و ویژگی های برنامه Google است. یک محصول میتواند دارای نسخههای سفارشیشده از شرایط، قیمتها و سایر جزئیات قرارداد باشد. هر یک از این نسخه های محصول با یک SKU محصول شناسایی می شوند. در این نسخه، Reseller API اشتراکی برای هر SKU در محصولات Google Workspace، Google Vault و Google Drive ارائه میکند. برای اطلاعات بیشتر، به محصولات و SKU ها مراجعه کنید.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Reseller API overview\n\nOne of the ways Google offers Google product services to users is through\nservice distribution channels such as the authorized Google Workspace resellers.\nWhen working with the Reseller API, it's important to understand the\nconceptual relationships of resellers to customers, payment plans, product SKUs,\nand licenses.\n\nReseller\n--------\n\nA reseller buys user licenses from Google and resells these licenses to Google\ncustomers. A reseller can manage customer subscriptions directly, or, if\ncustomizing multiple services, a reseller can work with a service integrator to\nmanage customers.\n\nResellers can choose from the following plans:\n\n- **annual commitment:** The reseller purchases a fixed amount of licenses from Google for one year. Customers can create up to the license count, but resellers are billed for the number of licenses ordered. If customers need additional licenses, resellers can use the [`subscriptions.changeSeats`](/workspace/admin/reseller/v1/reference/subscriptions/changeSeats) API call to raise the number of licenses ordered.\n- **flexible:** Every time a customer creates a new user, Google charges the reseller for this license. The reseller's contract with Google describes the price, specifications, and maximum number of licenses.\n\nAlong with managing user licenses, the reseller (or its partnered service\nintegrators) provide customers with a broad range of additional services such as\ntraining, promotions, advertising, pricing, deployment customizations,\ntroubleshooting, and maintenance.\n\nLicenses\n--------\n\nA license lets a user with a Google account access Google Workspace\nservices. When a customer assigns a license to a user, it becomes an active\nlicense. Only active licenses are counted when calculating a customer's total\nnumber of users.\n\nCustomer\n--------\n\nA Google customer begins with a Google Workspace account that the\nreseller configures. When setting up the customer's account, the reseller\nsupplies a primary domain name, alternate email, and a physical address. Then,\nthe reseller also creates a subscription for each product SKU available to the\ncustomer. The customer hosts each individual user account. For more information,\nsee\n[Order a new customer account](/workspace/admin/reseller/v1/how-tos/manage_customers#order_a_new_customer_account).\n\nPlans\n-----\n\nA plan defines a reseller's billing terms with Google. These plans don't define\nthe billing relationship between a reseller and their customers. Resellers\ndefine their own billing terms with their customers.\n\nReseller API\nsupports the Google Workspace monthly post-pay system, which has several available\npayment plans:\n\n- `ANNUAL_MONTHLY_PAY`: Annual commitment with monthly payments\n- `ANNUAL_YEARLY_PAY`: Annual commitment with one yearly payment\n- `FLEXIBLE`: Non-commitment plan with monthly payments\n- `TRIAL`: Free trial plan\n - Trial length is variable up to a maximum of 30 days.\n - Daily Gmail sending limit of 500 messages per user.\n- `FREE`: Free plan **only** for Cloud Identity Free Edition subscriptions\n\nFor more information on these plans, see\n[Choose a payment plan for your customers](https://support.google.com/a/answer/1720041).\n\nSubscription\n------------\n\nA subscription manages the relationship of a Google customer's\npayment plan with a product's SKU, user licenses, 30-day free trial status, and\nrenewal options. A primary role of a reseller is to manage the Google customer's\nsubscriptions.\n\nIn the Reseller API, a subscription is a primary API resource. It\ndefines the settings for a payment plan, licenses, 30-day free trial, renewal,\nand a reseller's purchase order. A customer can have more than one subscription,\none for each product SKU that the reseller assigns to the customer.\n\nEach subscription has a unique identifier, a `subscriptionId`. Because a\n`subscriptionId` changes when the subscription changes, don't use a\n`subscriptionId` value as a key for persistent data. This key will break if the\nsubscription changes.\n\nFor more information, see [Manage subscriptions](/workspace/admin/reseller/v1/how-tos/manage_subscriptions).\n\nProducts and product SKUs\n-------------------------\n\nA product is a commercial offering of a specialized set of Google service and\napplication features. A product can have customized versions of terms, pricing,\nand other agreement details. Each of these product versions is identified by a\nproduct SKU. In this version, the Reseller API offers a subscription\nfor each SKU in the Google Workspace, Google Vault, and Google Drive products.\nFor more information, see\n[Products \\& SKUs](/workspace/admin/reseller/v1/how-tos/products)."]]