اعتبارًا من
8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على
صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
نظرة عامة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يحدِّد إذن وصول المستخدِم العمليات التي يمكن للأفراد تنفيذها ضمن
منتج "مساحة العرض والفيديو 360". يتم التعرّف على المستخدِمين من خلال حساب Google
المستخدَم أثناء المصادقة. يتم تحديد مدى وصول المستخدِم
حسب أدوار المستخدِم المُسنَدة إليه، والتي تكون مرتبطة بموارد Partner أو Advertiser في "مساحة العرض والفيديو 360 ".
يوضّح هذا الدليل كيفية العثور على المستخدِمين وإنشائهم، بالإضافة إلى إسناد دور
المستخدِم إليهم من خلال واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360".
المتطلبات الأساسية
قبل بدء استخدام خدمات واجهة برمجة التطبيقات لمستخدمي "مساحة العرض والفيديو 360"، عليك
إكمال الخطوات التالية. تواصَل مع مستخدم مشرف حالي في فريقك لمحاولة تفعيل أدوار المستخدِمين اللازمة في "مساحة العرض والفيديو 360"، إذا لزم الأمر:
أنشئ مشروع واجهة برمجة تطبيقات وأذِن به كما هو موضّح في دليل
البدء.
تأكَّد من اتّباع مسار حساب الخدمة
للتفويض. يمكن فقط لحسابات الخدمة الوصول إلى خدمة واجهة برمجة التطبيقات
users في "مساحة العرض والفيديو 360". يجب أيضًا استخدام نطاق OAuth خاص users
بالخدمة في عملية المصادقة.
تأكَّد من أنّ حساب الخدمة هو حساب مستخدم على "مساحة العرض والفيديو 360"، وأنّه يمتلك أدوار المستخدمين المطلوبة للموارد اللازمة. لا يسمح لك سوى دور
المشرف بإجراء تغييرات على مستخدم وأدواره
المسنَدة إليه. لا يمنحك أي دور عادي آخر سوى
إذن بالقراءة لموارد المستخدمين.
فهم أدوار المستخدمين
تحدِّد أدوار المستخدِمين المحدّدة مستوى الوصول الذي يحصل عليه المستخدِمون إلى موارد عرض الإعلانات المختلفة في "مساحة العرض والفيديو 360". في ما يلي بعض النقاط المهمة التي يجب معرفتها عن دور العميل:
يمكن منح دور مستخدم لنوعَين مختلفَين من الموارد:
Advertiser وPartner.
لا يمكن منح بعض أدوار المستخدمين إلا لنوع مورد معيّن.
يمنح دور المستخدِم الذي يتم تعيينه لشريك هذا المستوى من الوصول تلقائيًا
لجميع المعلِنين التابعين لهذا الشريك.
تتحكّم أدوار المستخدمين أيضًا في المستخدمين الآخرين الذين يمكنك الوصول إليهم، وما إذا كان بإمكانك
إنشاء مستخدمين أو تعديل الأدوار المخصّصة للمستخدمين الآخرين. بصفتك مستخدمًا، يمكنك
الاطّلاع فقط على المستخدمين الذين يتشاركون إمكانية الوصول إلى المورد نفسه. على سبيل المثال، إذا كان لديك إذن وصول عادي إلى مورد شريك، سيتم تضمين جميع المستخدِمين الذين لديهم إذن وصول إلى ذلك الشريك أو أيّ من المعلِنين التابعين له في استجابة users.list.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
