از
8 سپتامبر 2025 ، هر مورد خط جدید باید اعلام کند که آیا تبلیغات سیاسی اتحادیه اروپا (EU) را ارائه می دهد یا خیر. Display & Video 360 API و بارگذاری‌های SDF که اعلان‌ها را ارائه نمی‌کنند با شکست مواجه می‌شوند. برای جزئیات بیشتر در مورد نحوه به روز رسانی یکپارچه سازی خود برای ایجاد این اعلامیه، به
صفحه لغو اعتبار ما مراجعه کنید.
نمای کلی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
دسترسی کاربر بر عملیاتی که افراد می توانند در محصول Display & Video 360 انجام دهند کنترل می کند. کاربران با حساب Google مورد استفاده در هنگام احراز هویت شناسایی می شوند. میزان دسترسی کاربر بر اساس نقش‌های کاربری اختصاص‌داده‌شده به آنها تعیین می‌شود که به منابع Partner Display & Video 360 یا Advertiser مرتبط هستند.
این راهنما نحوه یافتن و ایجاد کاربران و همچنین اختصاص نقش های کاربری به آنها از طریق Display & Video 360 API را شرح می دهد.
پیش نیازها
قبل از شروع کار با سرویس‌های Display & Video 360 API User، باید مراحل زیر را انجام دهید. با یک کاربر مدیر موجود در تیم خود تماس بگیرید تا در صورت لزوم، نقش‌های کاربری Display & Video 360 را فعال کنید:
همانطور که در راهنمای شروع ما ذکر شده است، یک پروژه API ایجاد و مجوز دهید.
مطمئن شوید که جریان حساب سرویس را برای مجوز دنبال می‌کنید. فقط حساب‌های سرویس می‌توانند به سرویس users Display & Video 360 API دسترسی داشته باشند. یک محدوده OAuth مخصوص سرویس users نیز باید در فرآیند احراز هویت استفاده شود.
اطمینان حاصل کنید که حساب سرویس یک کاربر Display & Video 360 است و نقش های کاربری لازم برای منابع لازم را دارد. فقط نقش Admin به شما امکان می دهد تغییراتی در یک کاربر و نقش های کاربری اختصاص داده شده به او ایجاد کنید. هر نقش استاندارد دیگری فقط به شما امکان دسترسی خواندن به منابع کاربر را می دهد.
نقش های کاربر را درک کنید
نقش‌های کاربر تعیین‌شده میزان دسترسی کاربران به منابع مختلف نمایش و ویدیو 360 را تعیین می‌کند. نکات مهمی که باید در مورد نقش های کاربر بدانید عبارتند از:
نقش کاربر را می توان برای دو نوع منبع مختلف داد: Advertiser و Partner .
برخی از نقش های کاربر را فقط می توان برای یک نوع منبع خاص اختصاص داد.
نقش کاربری اختصاص داده شده به یک شریک به طور خودکار به همه تبلیغ‌کنندگان تحت آن شریک دسترسی به آن سطح را می‌دهد.
نقش‌های کاربر همچنین کنترل می‌کنند که به کدام یک از کاربران دیگر دسترسی دارید، و اینکه آیا می‌توانید کاربران ایجاد کنید یا نقش‌های اختصاص داده شده دیگران را تغییر دهید. به عنوان یک کاربر، شما فقط می توانید کاربرانی را ببینید که دسترسی به یک منبع مشترک دارند. به عنوان مثال، اگر به منبع شریک دسترسی استاندارد دارید، همه کاربرانی که به آن شریک یا هر یک از تبلیغ‌کنندگان تحت آن دسترسی دارند، در پاسخ روش users.list گنجانده می‌شوند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eDisplay & Video 360 user access is determined by assigned user roles linked to Partner or Advertiser resources.\u003c/p\u003e\n"],["\u003cp\u003eThis guide explains how to find, create, and assign user roles to users through the Display & Video 360 API using service accounts.\u003c/p\u003e\n"],["\u003cp\u003eOnly Admin user roles can modify users and their roles; other roles only provide read access to user resources.\u003c/p\u003e\n"],["\u003cp\u003eUser access is limited to resources they share with other users, meaning visibility is restricted to users with overlapping resource access.\u003c/p\u003e\n"],["\u003cp\u003eUser roles can be assigned at the Partner or Advertiser level, with some roles specific to a resource type and Partner-level roles granting access to all advertisers under that Partner.\u003c/p\u003e\n"]]],["Users in Display & Video 360 are identified by their Google account, and their actions are dictated by assigned roles linked to Partner or Advertiser resources. To use the API, an API project needs authorization, and only service accounts can access the user service with a specific OAuth scope. Admin users can create and modify users and roles; others can only read. User roles grant access to resources; roles at the partner level automatically apply to all advertisers. Users can only see those with access to the same resources.\n"],null,["# Overview\n\nUser access governs the operations individuals can do within the\nDisplay \\& Video 360 product. [Users](/display-video/api/reference/rest/current/users) are identified by the Google\naccount used during authentication. The extent of a user's access is determined\nby their assigned user roles, which are linked to Display \\& Video 360\n[`Partner`](/display-video/api/reference/rest/current/partners) or [`Advertiser`](/display-video/api/reference/rest/current/advertisers) resources.\n\nThis guide describes how to find and create users, as well as assign them user\nroles through the Display \\& Video 360 API.\n\nPrerequisites\n-------------\n\nBefore you start working with Display \\& Video 360 API User services, you'll need to\ncomplete the following steps. Contact an existing **Admin** user on your team to\nhave the necessary Display \\& Video 360 user roles enabled, if necessary:\n\n1. Create and authorize an API project as outlined in our\n [Get Started](/display-video/api/guides/getting-started) guide.\n\n2. Ensure that you're following the [service account](/display-video/api/guides/how-tos/service-account)\n flow for authorization. Only service accounts can access the Display \\& Video 360 API\n [`users`](/display-video/api/reference/rest/current/users) service. An [OAuth scope specific to the `users`\n service](/display-video/api/reference/rest/current/users/get#authorization-scopes) must also be used in the authentication process.\n\n3. Ensure that the service account is a Display \\& Video 360 user, and has the\n requisite [user roles](//support.google.com/displayvideo/answer/2723011) for the necessary resources. Only the\n [Admin](/display-video/api/reference/rest/current/users#UserRole.ENUM_VALUES.ADMIN) role allows you to make changes to a user and their\n assigned user roles. Any other [standard role](//support.google.com/displayvideo/answer/2723011#user-roles) only gives\n you read access to user resources.\n\nUnderstand user roles\n---------------------\n\nAssigned user roles determine the level of access users have to different\nDisplay \\& Video 360 ad-serving resources. Important things to know about user\nroles include:\n\n- A user role can be given for two different resource types:\n [`Advertiser`](/display-video/api/reference/rest/current/advertisers) and [`Partner`](/display-video/api/reference/rest/current/partners).\n\n- Some user roles can only be assigned for a specific resource type.\n\n- A user role assigned for a partner automatically grants that level of access\n to all advertisers under that partner.\n\nUser roles also control which other users you have access to, and whether you\ncan create users and or modify others' assigned roles. **As a user, you can\nonly see users who share access to the same resource.** For example, if you\nhave standard access to a partner resource, all users who have access to that\npartner or any of the advertisers under it will be included in a\n[`users.list`](/display-video/api/reference/rest/current/users/list) method response."]]
