REST Resource: users

منبع: کاربر

یک منبع کاربری.

نمایش JSON 
{
  "name": string,
  "email": string,
  "accessState": enum (AccessState),
  "expirationTime": string,
  "partial": boolean,
  "developerAccountPermissions": [
    enum (DeveloperLevelPermission)
  ],
  "grants": [
    {
      object (Grant)
    }
  ]
}
فیلدها
name

string

الزامی. نام منبع برای این کاربر، مطابق با الگوی "developers/{developer}/users/{email}".

email

string

تغییرناپذیر. آدرس ایمیل کاربر.

accessState

enum ( AccessState )

فقط خروجی. وضعیت دسترسی کاربر به کنسول Play.

expirationTime

string ( Timestamp format)

زمانی که دسترسی کاربر در آن زمان منقضی می‌شود، در صورت تنظیم. هنگام تنظیم این مقدار، باید همیشه در آینده باشد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

partial

boolean

فقط خروجی. اینکه آیا مجوزهای بیشتری برای کاربر وجود دارد که در اینجا نمایش داده نشده است. این اتفاق می‌تواند در صورتی رخ دهد که تماس‌گیرنده مجوز مدیریت همه برنامه‌های موجود در حساب را نداشته باشد. این موضوع در صورتی که این کاربر مالک حساب باشد نیز true است.

اگر این فیلد true باشد، باید به عنوان سیگنالی در نظر گرفته شود که این کاربر نمی‌تواند به طور کامل از طریق API مدیریت شود. یعنی، فراخوانی‌کننده API قادر به مدیریت تمام مجوزهایی که این کاربر دارد نیست، یا به این دلیل که از آنها اطلاعی ندارد یا به این دلیل که کاربر صاحب حساب است.

developerAccountPermissions[]

enum ( DeveloperLevelPermission )

مجوزهایی برای کاربر که در سراسر حساب توسعه‌دهنده اعمال می‌شود.

grants[]

object ( Grant )

فقط خروجی. مجوزهای هر برنامه برای کاربر.

وضعیت دسترسی

وضعیت دسترسی کاربر به حساب توسعه‌دهنده.

انوم‌ها
ACCESS_STATE_UNSPECIFIED وضعیت دسترسی نامشخص یا نامشخص.
INVITED کاربر دعوت شده است اما هنوز دعوت را نپذیرفته است.
INVITATION_EXPIRED دعوتنامه منقضی شده است.
ACCESS_GRANTED کاربر دعوت را پذیرفته و به کنسول Play دسترسی دارد.
ACCESS_EXPIRED دسترسی به حساب کاربری منقضی شده است.

سطح توسعه‌دهنده

مجوزی که در سطح حساب توسعه‌دهنده اعطا شده است.

انوم‌ها
DEVELOPER_LEVEL_PERMISSION_UNSPECIFIED مجوز ناشناخته یا نامشخص.
CAN_SEE_ALL_APPS

مشاهده اطلاعات برنامه و دانلود گزارش‌های انبوه (فقط خواندنی). منسوخ شده: گزینه CAN_VIEW_NON_FINANCIAL_DATA_GLOBAL را علامت بزنید.

CAN_VIEW_FINANCIAL_DATA_GLOBAL مشاهده اطلاعات مالی، سفارشات و پاسخ‌های نظرسنجی لغو سفارش.
CAN_MANAGE_PERMISSIONS_GLOBAL مدیر (با تمام دسترسی‌ها).
CAN_EDIT_GAMES_GLOBAL ویرایش پروژه‌های سرویس‌های بازی‌های Play.
CAN_PUBLISH_GAMES_GLOBAL پروژه‌های سرویس‌های بازی‌های Play را منتشر کنید.
CAN_REPLY_TO_REVIEWS_GLOBAL نقدها.پاسخ به نقدها.
CAN_MANAGE_PUBLIC_APKS_GLOBAL انتشار به محیط عملیاتی، حذف دستگاه‌ها و استفاده از امضای برنامه توسط گوگل پلی.
CAN_MANAGE_TRACK_APKS_GLOBAL انتشار به مسیرهای آزمایشی.
CAN_MANAGE_TRACK_USERS_GLOBAL مدیریت مسیرهای تست و ویرایش لیست تسترها.
CAN_MANAGE_PUBLIC_LISTING_GLOBAL مدیریت حضور در فروشگاه
CAN_MANAGE_DRAFT_APPS_GLOBAL ایجاد، ویرایش و حذف پیش‌نویس برنامه‌ها
CAN_CREATE_MANAGED_PLAY_APPS_GLOBAL برنامه‌های خصوصی را برای سازمان خود ایجاد و منتشر کنید.
CAN_CHANGE_MANAGED_PLAY_SETTING_GLOBAL انتخاب کنید که آیا برنامه‌ها عمومی هستند یا فقط برای سازمان شما در دسترس هستند.
CAN_MANAGE_ORDERS_GLOBAL مدیریت سفارشات و اشتراک‌ها.
CAN_MANAGE_APP_CONTENT_GLOBAL صفحات مربوط به خط‌مشی را در تمام برنامه‌ها برای توسعه‌دهنده مدیریت کنید.
CAN_VIEW_NON_FINANCIAL_DATA_GLOBAL مشاهده اطلاعات برنامه و دانلود گزارش‌های انبوه (فقط خواندنی).
CAN_VIEW_APP_QUALITY_GLOBAL اطلاعات کیفیت برنامه را برای همه برنامه‌های مربوط به توسعه‌دهنده مشاهده کنید.

روش‌ها

create

 به یک کاربر، دسترسی به حساب توسعه‌دهنده‌ی داده‌شده را اعطا کنید.

delete

 تمام دسترسی‌های کاربر به حساب توسعه‌دهنده‌ی داده‌شده را حذف می‌کند.

list

 فهرست تمام کاربرانی که به حساب توسعه‌دهنده دسترسی دارند.

patch

 دسترسی کاربر به حساب توسعه‌دهنده را به‌روزرسانی می‌کند.

کدهای خطا

عملیات این منبع، کدهای خطای HTTP زیر را برمی‌گرداند:

کد خطا دلیل توضیحات وضوح تصویر
400 invalidValue مقدار نامعتبری در درخواست ارائه شده است. این اغلب به عنوان یک توکن خرید ناقص یا نامعتبر برگردانده می‌شود. مقدار فیلد نامعتبر را در بدنه درخواست یا پارامترها بر اساس مرجع API اصلاح کنید.
400 required یک فیلد یا پارامتر الزامی در درخواست وجود ندارد. برای اطمینان از وجود تمام فیلدها و پارامترهای اجباری، به مستندات API مراجعه کنید.
403 userInsufficientPermission کاربر مجوز کافی برای انجام عملیات درخواستی را ندارد. مطمئن شوید که کاربر احراز هویت شده مجوزهای لازم را در کنسول گوگل پلی دارد. برای جزئیات بیشتر به بخش «استفاده از حساب کاربری سرویس» مراجعه کنید.
404 notFound منبع مورد نظر یافت نشد. تأیید کنید که شناسه‌ها (مثلاً توکن خرید، نام بسته، شناسه محصول، شناسه اشتراک) صحیح باشند.
409 concurrentUpdate تلاشی برای به‌روزرسانی شیء‌ای که به‌طور همزمان به‌روزرسانی می‌شود، صورت گرفته است. درخواست را با backoff نمایی دوباره امتحان کنید. از تغییرات همزمان در همان منبع خودداری کنید.
5xx Generic error خطای عمومی در سرور گوگل پلی. درخواست خود را دوباره امتحان کنید.

اگر مشکل همچنان ادامه داشت، با مدیر حساب Google Play خود تماس بگیرید یا درخواست پشتیبانی ارسال کنید. داشبورد وضعیت Play را برای هرگونه قطعی شناخته شده بررسی کنید.