Package google.ads.datamanager.v1

string

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

این باید با شناسه ارسال شده در جریان پیوند مطابقت داشته باشد.

EventType

الزامی. نوع رویداد.

Timestamp

الزامی. زمان وقوع رویداد.

string

اختیاری. شناسه‌ای که توسط تماس‌گیرنده ایجاد و مدیریت می‌شود و به طور منحصر به فرد این رویداد را مشخص می‌کند.

اگر می‌خواهید رویدادهای تبلیغاتی که در چندین درخواست گنجانده شده‌اند را حذف کنید، الزامی است. در غیر این صورت، این فیلد اختیاری است.

UserData

اختیاری. چندین قطعه داده ارائه شده توسط کاربر، که نشان دهنده کاربری است که رویداد با آن مرتبط است.

می‌توان چندین نمونه از یک نوع داده (مثلاً آدرس ایمیل) ارائه داد. هرچه داده‌های بیشتری ارائه شود، احتمال یافتن تطابق بیشتر می‌شود.

DeviceInfo

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

string

اختیاری. آدرس IP مورد استفاده برای اندازه‌گیری. این مقدار باید با DeviceInfo.ip_address یکسان باشد. اگر نمی‌خواهید IP را برای اندازه‌گیری به اشتراک بگذارید، آن را خالی بگذارید.

string

اختیاری. شناسه دستگاهی که تبلیغ به آن نمایش داده شده است.

string

الزامی. شناسه کمپین مرتبط.

string

الزامی. نام کمپین مرتبط.

string

اختیاری. شناسه گروه تبلیغاتی مرتبط.

string

اختیاری. شناسه تبلیغ مرتبط در گروه.

int32

اختیاری. ارتفاع تبلیغ بر حسب پیکسل.

int32

اختیاری. عرض تبلیغ بر حسب پیکسل.

string

اختیاری. کشور به علاوه‌ی تقسیمات کشوری بر اساس استاندارد ISO 3166-2.

string

الزامی. منبع پلتفرم تبلیغ، مشابه منبع گوگل آنالیتیکس.

string

الزامی. رسانه‌ی تبلیغ، مشابه رسانه‌ی گوگل آنالیتیکس.

AttributionHint

اختیاری. وضعیت انتساب فرض‌شده توسط شریک برای این رویداد تبلیغاتی.

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

ViewabilityInfo

الزامی. جزئیات میزان بازدید تبلیغ ارائه شده.

EventSubtype

مقدار شمارشی برای زیرنوع رویداد.

string

مقدار رشته‌ای برای زیرنوع رویداد.

AdType

مقدار شمارشی برای نوع تبلیغ.

string

مقدار رشته‌ای برای نوع تبلیغ.

AdFormat

مقدار شمارشی برای قالب تبلیغ.

string

مقدار رشته‌ای برای قالب تبلیغ.

AdPlacement

مقدار شمارشی برای قرار دادن تبلیغ.

string

مقدار رشته‌ای برای قرار دادن تبلیغ.

TargetingType

مقدار شمارشی برای نوع هدف‌گیری.

string

مقدار رشته‌ای برای نوع هدف‌گیری.

PlatformType

مقدار شمارشی برای نوع پلتفرم.

string

مقدار رشته‌ای برای نوع پلتفرم.

Platform

مقدار شمارشی برای پلتفرم.

string

مقدار رشته‌ای برای پلتفرم.

bool

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

string

اختیاری. ویژگی‌های جلسه برای انتساب و مدل‌سازی رویداد.

string

اختیاری. شناسه کلیک گوگل (gclid) مرتبط با این رویداد.

string

اختیاری. شناسه کلیک برای کلیک‌های مرتبط با رویدادهای برنامه و منشأ گرفته از دستگاه‌های iOS با شروع iOS14.

string

اختیاری. شناسه کلیک برای کلیک‌های مرتبط با رویدادهای وب و منشأ گرفته از دستگاه‌های iOS از iOS14 به بعد.

DeviceInfo

اختیاری. اطلاعات جمع‌آوری‌شده در مورد دستگاه مورد استفاده (در صورت وجود) در زمان ورود به سایت تبلیغ‌کننده پس از تعامل با تبلیغ.

string

اختیاری. شناسه موبایل برای تبلیغ‌کنندگان. این شناسه می‌تواند در iOS، IDFA، در اندروید، AdID یا شناسه‌های سایر پلتفرم‌ها برای تبلیغ‌کنندگان باشد.

string

اختیاری. شناسه کلیک نمایش داده شده مرتبط با این رویداد.

string

اختیاری. شناسه‌ی نمایش مرتبط با این رویداد.

string

اختیاری. فیلد شناسه تطبیق برای اتصال این رویداد به رویداد قبلی استفاده می‌شود.

EncryptedUserId

اختیاری. هر تعداد شناسه کاربری رمزگذاری شده.

string

اختیاری. یک شناسه منحصر به فرد برای یک کاربر احراز هویت شده (وارد سیستم شده)، همانطور که توسط ناشر تعریف شده است.

string

اختیاری. یک شناسه منحصر به فرد برای کاربر احراز هویت نشده (کاربری که وارد سیستم نشده است)، همانطور که توسط ناشر تعریف شده است.

string

الزامی. نام (کوچک) کاربر، تماماً با حروف کوچک، بدون نقطه‌گذاری، بدون فاصله‌ی خالی در ابتدا یا انتهای کلمه، و به صورت SHA-256 هش شده.

string

الزامی. نام خانوادگی (فامیلی) کاربر، تماماً با حروف کوچک، بدون نقطه‌گذاری، بدون فاصله‌ی خالی در ابتدا یا انتهای کلمه، و به صورت SHA-256 هش شده.

string

الزامی. کد منطقه دو حرفی در استاندارد ISO-3166-1 alpha-2 مربوط به آدرس کاربر.

string

الزامی. کد پستی آدرس کاربر.

string

اختیاری. خیابان و شماره آدرس کاربر. فقط برای گوگل آنالیتیکس استفاده می‌شود. این فیلد هش شده و احتمالاً رمزگذاری شده است.

قبل از هش کردن، مقدار را نرمال‌سازی کنید:

• حذف کاراکترهای نماد
• تبدیل به حروف کوچک
• حذف فضای خالی ابتدا و انتهای متن

string

اختیاری. شهر آدرس کاربر. فقط برای گوگل آنالیتیکس استفاده می‌شود.

مقدار باید به این صورت نرمال‌سازی شود:

• حذف کاراکترهای نماد
• تبدیل به حروف کوچک
• حذف فضای خالی ابتدا و انتهای متن

string

اختیاری. منطقه اداری (ایالت/استان) آدرس کاربر. فقط برای گوگل آنالیتیکس استفاده می‌شود.

مقدار باید به این صورت نرمال‌سازی شود:

• حذف کاراکترهای نماد
• تبدیل به حروف کوچک
• حذف فضای خالی ابتدا و انتهای متن

string

اختیاری. مشخص می‌کند که مخاطب به کدام Destination ارسال شود.

Consent

اختیاری. تنظیم رضایت برای کاربر.

UserData

داده‌های ارائه شده توسط کاربر که کاربر را شناسایی می‌کند.

PairData

شناسه‌های تطبیق هویت ناشر و تبلیغ‌کننده (PAIR) .

این ویژگی فقط برای شرکای داده در دسترس است.

MobileData

داده‌هایی که دستگاه‌های تلفن همراه کاربر را شناسایی می‌کنند.

UserIdData

داده‌های مربوط به شناسه‌های منحصر به فرد برای یک کاربر، همانطور که توسط تبلیغ‌کننده تعریف شده است.

PpidData

داده‌های مربوط به شناسه‌های ارائه شده توسط ناشر.

این ویژگی فقط برای شرکای داده در دسترس است.

CompositeData

گروهی از چندین نوع شناسه.

GoogleUserIdData

شناسه‌های کاربری رمزگذاری‌شده‌ی گوگل

PartnerProvidedIdData

شناسه‌های ارائه شده توسط شریک.

KeyType

الزامی. نوع الگوریتم مورد استفاده برای رمزگذاری داده‌ها.

string

الزامی. نام منبع آمازون مربوط به نقش IAM که برای دسترسی به رمزگشایی KMS در نظر گرفته شده است. باید به فرمت arn:{partition}:iam::{account_id}:role/{role_name} باشد.

string

الزامی. آدرس اینترنتی (URI) کلید AWS KMS که برای رمزگشایی DEK استفاده می‌شود. باید به فرمت arn:{partition}:kms:{region}:{account_id}:key/{key_id} یا aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id}

string

الزامی. کلید رمزگذاری داده‌های رمزگذاری شده با کد base64.

Location

مکان پایه درخواست. مکان پایه یک لیست OR از مناطق درخواستی است.

bool

اگر روی درست تنظیم شود، سرویس سعی می‌کند به‌طور خودکار موقعیت پایه را برای دریافت اطلاعات شناسایی کند.

string

فهرست کدهای منطقه‌ای ISO 3166-1 alpha-2.

string

اختیاری. شناسه مرکز فروش مرتبط با اقلام.

string

اختیاری. برچسب فید مرکز فروشندگان که با فید اقلام مرتبط است.

string

اختیاری. کد زبان در ISO 639-1 مرتبط با فید مرکز فروشندگان اقلام. جایی که اقلام شما آپلود می‌شوند.

double

اختیاری. مجموع تمام تخفیف‌های مرتبط با تراکنش.

Item

اختیاری. فهرست موارد مرتبط با رویداد.

string

اختیاری. فهرست کدهای تخفیفی که به سبد خرید اعمال شده‌اند. کدهای تخفیف سطح سبد خرید و سطح کالا مستقل هستند.

اگر رویداد مربوط به یک مقصد گوگل آنالیتیکس است، فقط یک کد تخفیف ارائه دهید. گوگل آنالیتیکس کدهای تخفیف اضافی را نادیده می‌گیرد.

UserData

اختیاری. داده‌های ارائه شده توسط کاربر که کاربر را شناسایی می‌کند.

IpData

اختیاری. داده‌های آدرس IP که نشان‌دهنده تعامل مشتری است و برای ایجاد مخاطب استفاده می‌شود.

ConsentStatus

اختیاری. نشان می‌دهد که آیا کاربر با داده‌های کاربر تبلیغاتی موافقت می‌کند یا خیر.

ConsentStatus

اختیاری. نشان می‌دهد که آیا کاربر با شخصی‌سازی تبلیغ موافقت می‌کند یا خیر.

int32

فقط خروجی. نرخ تطابق برای لیست‌های کاربر منطبق با مشتری.

DataSourceType

اختیاری. تغییرناپذیر. منبع داده‌های آپلود

string

الزامی. شناسه‌ی کلید هماهنگ‌کننده‌ی انتخاب‌شده.

string

الزامی. والد، که مالک این مجموعه از لینک‌های همکار است. قالب: accountTypes/{account_type}/accounts/{account}

PartnerLink

الزامی. لینک همکاری که باید ایجاد شود.

string

الزامی. حسابی که مالک فهرست کاربران دارای مجوز است. باید به فرمت accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} باشد.

UserListDirectLicense

الزامی. فهرست کاربران، مجوز مستقیم برای ایجاد.

string

الزامی. حسابی که مالک فهرست کاربران دارای مجوز است. باید به فرمت accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} باشد.

UserListGlobalLicense

الزامی. فهرست کاربران، مجوز سراسری برای ایجاد.

string

الزامی. حساب والد که این فهرست کاربران در آن ایجاد خواهد شد. قالب: accountTypes/{account_type}/accounts/{account}

UserList

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

bool

اختیاری. اگر مقدار آن درست باشد، درخواست اعتبارسنجی می‌شود اما اجرا نمی‌شود.

string

اختیاری. نام متغیر سفارشی که قرار است تنظیم شود. اگر متغیر برای مقصد داده شده پیدا نشود، نادیده گرفته می‌شود.

string

اختیاری. مقداری که قرار است برای متغیر سفارشی ذخیره شود.

string

اختیاری. رشته مرجعی که برای تعیین اینکه متغیر سفارشی باید به کدام یک از Event.destination_references ارسال شود، استفاده می‌شود. در صورت خالی بودن، از Event.destination_references استفاده خواهد شد.

string

الزامی. نام منبع لینک همکار برای حذف. قالب: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

string

الزامی. نام فهرست کاربرانی که قرار است حذف شوند. قالب: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

bool

اختیاری. اگر مقدار آن درست باشد، درخواست اعتبارسنجی می‌شود اما اجرا نمی‌شود.

string

اختیاری. شناسه (ID) برای این منبع Destination ، منحصر به فرد در درخواست. برای ارجاع به این Destination در IngestEventsRequest و IngestAudienceMembersRequest استفاده می‌شود.

ProductAccount

اختیاری. حسابی که برای فراخوانی این API استفاده می‌شود. برای اضافه کردن یا حذف داده‌ها از operating_account ، این login_account باید دسترسی نوشتن به operating_account داشته باشد. به عنوان مثال، یک حساب کاربری مدیر operating_account یا حسابی با پیوند برقرار شده به operating_account .

ProductAccount

اختیاری. حسابی که login_account کاربر فراخوانی‌کننده از طریق یک لینک حساب ایجاد شده به آن دسترسی دارد. برای مثال، login_account یک شریک داده ممکن است به linked_account یک مشتری دسترسی داشته باشد. شریک ممکن است از این فیلد برای ارسال داده از linked_account به operating_account دیگری استفاده کند.

ProductAccount

الزامی. حسابی که قرار است داده‌ها به آن ارسال یا از آن حذف شوند.

string

اختیاری. شیء درون حساب محصول که قرار است در آن وارد شود. برای مثال، شناسه مخاطب گوگل ادز، شناسه مخاطب Display & Video 360 یا شناسه اقدام تبدیل گوگل ادز.

این فیلد برای دریافت رویداد Google Ad Manager و دریافت کاربر اختیاری است. برای سایر موارد استفاده الزامی است.

string

اختیاری. رشته‌ی عامل کاربر دستگاه برای زمینه‌ی داده شده.

string

اختیاری. آدرس IP دستگاه برای زمینه داده شده. هنگام استفاده در یک AdEvent برای بررسی‌های جغرافیایی، الزامی است.

string

اختیاری. دسته دستگاه. به عنوان مثال، "دسکتاپ"، "تبلت"، "موبایل"، "تلویزیون هوشمند".

string

اختیاری. زبانی که دستگاه با فرمت ISO 639-1 استفاده می‌کند.

int32

اختیاری. ارتفاع صفحه نمایش بر حسب پیکسل.

int32

اختیاری. عرض صفحه نمایش بر حسب پیکسل.

string

اختیاری. سیستم عامل یا پلتفرم دستگاه.

string

اختیاری. نسخه سیستم عامل یا پلتفرم.

string

اختیاری. مدل دستگاه.

string

اختیاری. نام تجاری دستگاه.

string

اختیاری. برند یا نوع مرورگر.

string

اختیاری. نسخه مرورگر.

string

الزامی. شناسه رمزگذاری شده الفبایی-عددی.

EncryptionEntityType

الزامی. نوع موجودیت رمزگذاری. این باید با پیکربندی رمزگذاری برای نمایش آگهی یا انتقال داده مطابقت داشته باشد.

int64

الزامی. شناسه‌ی موجودیت رمزگذاری. این شناسه باید با پیکربندی رمزگذاری برای نمایش آگهی یا انتقال داده مطابقت داشته باشد.

EncryptionSource

الزامی. توضیح می‌دهد که آیا کوکی رمزگذاری‌شده از سرویس پخش آگهی (ماکرو %m) یا از انتقال داده دریافت شده است.

GcpWrappedKeyInfo

پلتفرم ابری گوگل اطلاعات کلیدی را در خود جای داده است.

AwsWrappedKeyInfo

خدمات وب آمازون اطلاعات کلیدی را در بر گرفت.

CoordinatorKeyInfo

اطلاعات کلیدی برای کلید هماهنگ‌کننده‌ی انتخاب‌شده.

این مورد برای متدهای IngestEvents ، IngestAudienceMembers و RemoveAudienceMembers پشتیبانی نمی‌شود.

int64

تعداد رکوردهایی که به دلیل مشخصی آپلود نشده‌اند.

ProcessingErrorReason

دلیل خطای رکوردهای ناموفق.

ErrorCount

فهرستی از خطاها و تعداد آنها به ازای هر دلیل خطا. ممکن است در همه موارد پر نشود.

string

اختیاری. رشته مرجع مورد استفاده برای تعیین مقصد. در صورت خالی بودن، رویداد به تمام destinations در درخواست ارسال خواهد شد.

string

اختیاری. شناسه منحصر به فرد برای این رویداد. برای رویدادهایی که به عنوان منبع داده اضافی برای تبدیل برچسب ارسال می‌شوند، الزامی است.

Timestamp

الزامی. زمان وقوع رویداد.

Timestamp

اختیاری. آخرین باری که رویداد به‌روزرسانی شده است.

UserData

اختیاری. بخش‌هایی از داده‌های ارائه شده توسط کاربر، که نشان دهنده کاربری است که رویداد با آن مرتبط است.

Consent

اختیاری. اطلاعاتی در مورد اینکه آیا کاربر مرتبط انواع مختلفی از رضایت را ارائه داده است یا خیر.

AdIdentifiers

اختیاری. شناسه‌ها و سایر اطلاعات مورد استفاده برای تطبیق رویداد تبدیل با سایر فعالیت‌های آنلاین (مانند کلیک‌های تبلیغاتی).

string

اختیاری. کد ارزی مرتبط با تمام مقادیر پولی در این رویداد.

EventSource

اختیاری. علامتی برای محل وقوع رویداد (وب، اپلیکیشن، فروشگاه و غیره).

DeviceInfo

اختیاری. اطلاعات جمع‌آوری‌شده در مورد دستگاهی که هنگام وقوع رویداد مورد استفاده قرار گرفته است (در صورت وجود).

CartData

اختیاری. اطلاعات مربوط به تراکنش و موارد مرتبط با رویداد.

CustomVariable

اختیاری. اطلاعات جفت کلید/مقدار اضافی برای ارسال به کانتینرهای تبدیل (عمل تبدیل یا فعالیت FL).

ExperimentalField

اختیاری. فهرستی از جفت‌های کلید/مقدار برای فیلدهای آزمایشی که ممکن است در نهایت به عنوان بخشی از API ارتقا یابند.

UserProperties

اختیاری. اطلاعات ارزیابی‌شده توسط تبلیغ‌کننده درباره کاربر در زمان وقوع رویداد.

string

اختیاری. نام رویداد. برای رویدادهای GA4 الزامی است.

string

اختیاری. یک شناسه منحصر به فرد برای نمونه کاربری یک کلاینت وب برای این جریان وب GA4.

string

اختیاری. یک شناسه منحصر به فرد برای یک کاربر، همانطور که توسط تبلیغ کننده تعریف شده است.

EventParameter

اختیاری. مجموعه‌ای از پارامترهای رویداد که قرار است در رویداد گنجانده شوند و قبلاً با استفاده از فیلدهای ساختاریافته‌ی دیگر مشخص نشده‌اند.

UserData

اختیاری. همان نوع داده‌های ارائه شده در user_data، اما به صراحت به عنوان داده‌های متعلق به شخص ثالث و نه تبلیغ‌کننده شخص اول علامت‌گذاری شده است.

EventLocation

اختیاری. اطلاعات جمع‌آوری‌شده در مورد موقعیت مکانی کاربر هنگام وقوع این رویداد.

string

اختیاری. یک شناسه منحصر به فرد برای نمونه کاربر یک کلاینت برنامه برای این جریان برنامه GA4.

double

اختیاری. مقدار تبدیل مرتبط با رویداد، برای تبدیل‌های مبتنی بر ارزش.

double

اختیاری. مقدار تبدیل مرتبط با رویداد، برای تبدیل‌های مبتنی بر شمارش.

string

اختیاری. برای فروش فروشگاه الزامی است. شناسه‌ای برای نشان دادن فروشگاه فیزیکی که رویداد در آن رخ داده است.

string

اختیاری. نام شهری که رویداد در آن رخ داده است.

string

اختیاری. کد زیربخش ISO 3166-2 که رویداد در آن رخ داده است.

string

اختیاری. کد منطقه CLDR دو حرفی آدرس کاربر.

string

اختیاری. کد شبه قاره در قالب UN M49 که رویداد در آن رخ داده است.

string

اختیاری. کد قاره در قالب UN M49 که رویداد در آن رخ داده است.

string

الزامی. نام پارامتری که قرار است استفاده شود.

string

الزامی. نمایش رشته‌ای مقدار پارامتری که قرار است تنظیم شود.

string

اختیاری. نام فیلدی که قرار است استفاده شود.

string

اختیاری. مقداری که فیلد باید تنظیم کند.

WarningReason

دلیل هشدار.

string

پیام هشدار دقیقی که مشکل را شرح می‌دهد.

string

مسیر فیلدی که باعث ایجاد هشدار شده است. از همان قالب google.rpc.BadRequest.FieldViolation.field استفاده می‌کند.

KeyType

الزامی. نوع الگوریتم مورد استفاده برای رمزگذاری داده‌ها.

string

الزامی. ارائه‌دهنده‌ی استخر هویت بار کاری (Workload Identity Pool) ملزم به استفاده از KEK است.

string

الزامی. شناسه منبع سرویس مدیریت کلید ابری پلتفرم گوگل کلود. باید به فرمت projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} یا gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}

string

الزامی. کلید رمزگذاری داده‌های رمزگذاری شده با کد base64.

string

الزامی. نام منبع مجوز مستقیم فهرست کاربران.

string

الزامی. نام منبعِ مجوز سراسریِ فهرست کاربران.

string

الزامی. نام منبع فهرست کاربری که قرار است بازیابی شود. قالب: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

string

الزامی. فهرست شناسه‌های کاربری رمزگذاری‌شده‌ی گوگل.

AdEvent

الزامی. الزامی (حداقل ۱ مورد). فهرستی از رویدادهای تبلیغاتی.

EncryptionInfo

اختیاری. اطلاعات مربوط به کلیدهای رمزگذاری که برای رمزگذاری داده‌ها استفاده می‌شوند. این فیلد باید زمانی ارائه شود که رویدادهای تبلیغاتی حاوی UserData باشند.

bool

اختیاری. اگر درست باشد، درخواست اعتبارسنجی می‌شود، اما اجرا نمی‌شود.

Destination

الزامی. فهرست مقاصدی که مخاطبان باید به آنجا فرستاده شوند.

AudienceMember

الزامی. فهرست کاربرانی که باید به مقصدهای مشخص‌شده ارسال شوند. حداکثر ۱۰۰۰۰ منبع AudienceMember را می‌توان در یک درخواست واحد ارسال کرد.

Consent

اختیاری. رضایت در سطح درخواست برای همه کاربران در درخواست اعمال می‌شود. رضایت در سطح کاربر، رضایت در سطح درخواست را لغو می‌کند و می‌تواند در هر AudienceMember مشخص شود.

bool

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

Encoding

اختیاری. باید برای آپلودهای UserData ارائه شود. نوع رمزگذاری شناسه‌های کاربر. برای شناسه‌های کاربر هش‌شده، این نوع رمزگذاری رشته هش‌شده است. برای شناسه‌های کاربر هش‌شده رمزگذاری‌شده، این نوع رمزگذاری رشته رمزگذاری‌شده بیرونی است، اما لزوماً رشته هش‌شده داخلی نیست، به این معنی که رشته هش‌شده داخلی می‌تواند به روشی متفاوت از رشته رمزگذاری‌شده بیرونی رمزگذاری شود. برای آپلودهای غیر UserData ، این فیلد نادیده گرفته می‌شود.

EncryptionInfo

اختیاری. اطلاعات رمزگذاری برای آپلودهای UserData . اگر تنظیم نشود، فرض بر این است که اطلاعات شناسایی آپلود شده هش شده اما رمزگذاری نشده‌اند. برای آپلودهای غیر UserData ، این فیلد نادیده گرفته می‌شود.

TermsOfService

اختیاری. شرایط خدماتی که کاربر پذیرفته/رد کرده است.

string

شناسه‌ی خودکارِ ایجاد شده برای درخواست.

FieldWarning

هشدارهای دقیق در سطح ردیف با مسیرهای میدانی.

Destination

الزامی. فهرست مقاصدی که رویدادها به آنها ارسال می‌شوند.

Event

الزامی. فهرست رویدادهایی که باید به مقصدهای مشخص‌شده ارسال شوند. حداکثر ۲۰۰۰ منبع Event را می‌توان در یک درخواست واحد ارسال کرد.

Consent

اختیاری. رضایت در سطح درخواست برای همه کاربران موجود در درخواست اعمال می‌شود. رضایت در سطح کاربر، رضایت در سطح درخواست را لغو می‌کند و می‌تواند در هر Event مشخص شود.

bool

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

Encoding

Optional. Must be provided for UserData uploads. The encoding type of the user identifiers. For hashed user identifiers, this is the encoding type of the hashed string. For encrypted hashed user identifiers, this is the encoding type of the outer encrypted string, but not necessarily the inner hashed string, meaning the inner hashed string could be encoded in a different way than the outer encrypted string. For non UserData uploads, this field is ignored.

EncryptionInfo

اختیاری. اطلاعات رمزگذاری برای آپلودهای UserData . اگر تنظیم نشود، فرض بر این است که اطلاعات شناسایی آپلود شده هش شده اما رمزگذاری نشده‌اند. برای آپلودهای غیر UserData ، این فیلد نادیده گرفته می‌شود.

string

شناسه‌ی خودکارِ ایجاد شده برای درخواست.

FieldWarning

Detailed row-level warnings with field paths.

UploadKeyType

Required. Immutable. Upload key types of this user list.

ContactIdInfo

Optional. Additional information when CONTACT_ID is one of the upload_key_types .

MobileIdInfo

Optional. Additional information when MOBILE_ID is one of the upload_key_types .

UserIdInfo

Optional. Additional information when USER_ID is one of the upload_key_types .

PairIdInfo

Optional. Additional information when PAIR_ID is one of the upload_key_types .

این ویژگی فقط برای شرکای داده در دسترس است.

PseudonymousIdInfo

Optional. Additional information for PSEUDONYMOUS_ID is one of the upload_key_types .

PartnerAudienceInfo

Optional. Additional information for partner audiences.

این ویژگی فقط برای شرکای داده در دسترس است.

string

الزامی. آدرس IP در زمان تعامل با مشتری ثبت می‌شود. قالب‌های رشته‌ای استاندارد را برای IPv4 و IPv6 می‌پذیرد.

Timestamp

اختیاری. اولین زمان تعامل ثبت شده از این آدرس IP در یک جلسه.

Timestamp

اختیاری. آخرین زمان تعامل ثبت شده از این آدرس IP در یک جلسه.

string

Optional. The product ID within the Merchant Center account.

int64

Optional. The number of this item associated with the event.

double

Optional. The unit price excluding tax, shipping, and any transaction level discounts.

string

Optional. A unique identifier to reference the item.

ItemParameter

Optional. A bucket of any event parameters related to an item to be included within the event that were not already specified using other structured fields.

string

Optional. The Merchant Center ID associated with the item. For Store Sales events this will override the value set at the cart level. This field is ignored for other events.

string

Optional. The feed label of the Merchant Center feed. If countries are still being used, the 2-letter country code in ISO-3166-1 alpha-2 can be used instead. For Store Sales events this will override the value set at the cart level. This field is ignored for other events.

string

Optional. The language code in ISO 639-1 associated with the Merchant Center feed where your items are uploaded.

ItemCustomVariable

Optional. Additional key/value pair information to send to the conversion containers (conversion action or Floodlight activity), when tracking per-item conversions.

double

Optional. The conversion value associated with this item within the event, for cases where the conversion value is different for each item.

string

Optional. The name of the custom variable to set. If the variable is not found for the given destination, it will be ignored.

string

Optional. The value to store for the custom variable.

string

Optional. Reference string used to determine which of the Event.destination_references the custom variable should be sent to. If empty, the Event.destination_references will be used.

string

Required. The name of the parameter to use.

string

Required. The string representation of the value of the parameter to set.

string

Required. The account whose licenses are being queried. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

string

Optional. A filter string to apply to the list request. All fields need to be on the left hand side of each condition (for example: user_list_id = 123 ). Fields must be specified using either all camel case or all snake case . Don't use a combination of camel case and snake case.

Supported Operations:

• AND
• =
• !=
• >
• >=
• <
• <=

Supported Functions: - IN(field, value1, value2, ...) : returns true if the field matches any of the values. Example: IN(user_list_id, 123, 456)

Unsupported Fields:

• name (use get method instead)
• historical_pricings and all its subfields
• pricing.start_time
• pricing.end_time

int32

Optional. The maximum number of licenses to return per page. The service may return fewer than this value. If unspecified, at most 50 licenses will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

string

Optional. A page token, received from a previous ListUserListDirectLicense call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListUserListDirectLicense must match the call that provided the page token.

UserListDirectLicense

The licenses for the given user list in the request.

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

string

Required. The global license whose customer info are being queried. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID} . To list all global license customer info under an account, replace the user list global license id with a '-' (for example, accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/- )

string

Optional. A filter string to apply to the list request. All fields need to be on the left hand side of each condition (for example: user_list_id = 123 ). Fields must be specified using either all camel case or all snake case . Don't use a combination of camel case and snake case.

Supported Operations:

• AND
• =
• !=
• >
• >=
• <
• <=

Supported Functions: - IN(field, value1, value2, ...) : returns true if the field matches any of the values. Example: IN(user_list_id, 123, 456)

Unsupported Fields:

• name (use get method instead)
• historical_pricings and all its subfields
• pricing.start_time
• pricing.end_time

int32

Optional. The maximum number of licenses to return. The service may return fewer than this value. If unspecified, at most 50 licenses will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

string

Optional. A page token, received from a previous ListUserListDirectLicense call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListUserListDirectLicense must match the call that provided the page token.

UserListGlobalLicenseCustomerInfo

The customer information for the given license in the request.

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

string

Required. The account whose licenses are being queried. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

string

Optional. A filter string to apply to the list request. All fields need to be on the left hand side of each condition (for example: user_list_id = 123 ). Fields must be specified using either all camel case or all snake case . Don't use a combination of camel case and snake case.

Supported Operations:

• AND
• =
• !=
• >
• >=
• <
• <=

Supported Functions: - IN(field, value1, value2, ...) : returns true if the field matches any of the values. Example: IN(user_list_id, 123, 456)

Unsupported Fields:

• name (use get method instead)
• historical_pricings and all its subfields
• pricing.start_time
• pricing.end_time

int32

Optional. The maximum number of licenses to return. The service may return fewer than this value. If unspecified, at most 50 licenses will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

string

Optional. A page token, received from a previous ListUserListGlobalLicense call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListUserListDirectLicense must match the call that provided the page token.

UserListGlobalLicense

The licenses for the given user list in the request.

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

string

Required. The parent account which owns this collection of user lists. Format: accountTypes/{account_type}/accounts/{account}

int32

Optional. The maximum number of user lists to return. The service may return fewer than this value. If unspecified, at most 50 user lists will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

string

Optional. A page token, received from a previous ListUserLists call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListUserLists must match the call that provided the page token.

string

Optional. A filter string . All fields need to be on the left hand side of each condition (for example: display_name = "list 1" ). Fields must be specified using either all camel case or all snake case . Don't use a combination of camel case and snake case.

عملیات پشتیبانی شده:

• AND
• =
• !=
• >
• >=
• <
• <=
• : (has)

Supported Functions: - IN(field, value1, value2, ...) : returns true if the field matches any of the values. Example: IN(display_name, "name1", "name2")

فیلدهای پشتیبانی شده:

• id
• display_name
• description
• membership_status
• integration_code
• access_reason
• ingested_user_list_info.upload_key_types

UserList

The user lists from the specified account.

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

string

الزامی. فهرست شناسه‌های دستگاه تلفن همراه (شناسه تبلیغات اندروید، شناسه شناسایی iOS برای فهرست‌های کاربران Customer Match و شناسه تبلیغات اندروید، شناسه شناسایی iOS، شناسه Xbox یا Microsoft، شناسه Amazon Fire TV، شناسه Roku، شناسه دستگاه عمومی برای فهرست‌های کاربران پایه). حداکثر ۱۰ mobileIds می‌تواند در یک AudienceMember ارائه شود.

DataSourceType

Optional. Immutable. Source of the upload data.

KeySpace

Required. Immutable. The key space of mobile IDs.

string

Required. Immutable. A string that uniquely identifies a mobile application from which the data was collected.

string

الزامی. داده‌های PII ارائه شده توسط Cleanroom، هش شده با SHA256 و رمزگذاری شده با یک رمز جابجایی EC با استفاده از کلید ناشر برای لیست کاربران PAIR . حداکثر 10 pairIds می‌تواند در یک AudienceMember ارائه شود.

int64

Required. Immutable. Identifies the publisher that the Publisher Advertiser Identity Reconciliation user list is reconciled with. This field is provided by the cleanroom provider and is only unique in the scope of that cleanroom. This cannot be used as a global identifier across multiple cleanrooms.

string

Required. Descriptive name of the publisher to be displayed in the UI for a better targeting experience.

int32

Required. This field denotes the percentage of membership match of this user list with the corresponding publisher's first party data. Must be between 0 and 100 inclusive.

int64

Optional. The count of the advertiser's first party data records that have been uploaded to a clean room provider. This does not signify the size of a PAIR user list.

string

Required. Immutable. Identifies a unique advertiser to publisher relationship with one clean room provider or across multiple clean room providers.

PartnerAudienceSource

Required. Immutable. The source of the partner audience.

string

Optional. The commerce partner name. Only allowed if partner_audience_source is COMMERCE_AUDIENCE .

string

Required. The identifier of the customer account in the partner's ID space.

string

Optional. The name of the account.

string

Optional. The type of the account. Can be used to distinguish between advertiser accounts and business level accounts, for example.

string

Identifier. The name of the partner link. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

string

Output only. The partner link ID.

ProductAccount

Required. The owning account granting access to the partner account.

ProductAccount

Required. The partner account granted access by the owning account.

FeatureSet

Optional. Immutable. The set of features supported for the partner link. If not specified, the system behavior defaults to FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT .

PartnerCustomerAccount

Optional. The customer account in the partner system. This is required for partner links with the FEATURE_SET_AD_EVENT_MANAGEMENT feature set.

PartnerLinkMetadata

Optional. Metadata associated with the partner link. This is optional and only accepted for partner links with the FEATURE_SET_AD_EVENT_MANAGEMENT .

PartnerCustomerAccount

Optional. The list of implicit accounts.

string

الزامی. فهرست شناسه‌های ارائه شده توسط شریک.

string

الزامی. فهرست شناسه‌های ارائه شده توسط ناشر برای یک کاربر.

Product

Deprecated. Use account_type instead.

string

Required. The ID of the account. For example, your Google Ads account ID.

AccountType

Required. The type of the account. For example, GOOGLE_ADS . Either account_type or the deprecated product is required. If both are set, the values must match.

SyncStatus

Output only. Sync status of the user list.

int64

Optional. Immutable. The number of billable records (eg uploaded or matched).

Destination

الزامی. فهرست مقاصدی که کاربران باید از آنها حذف شوند.

Timestamp

Optional. The remove as of time. If set, only audience members last added before this time will be removed. If not set, it defaults to current time. The remove as of time must not be in the future.

bool

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

string

شناسه‌ی خودکارِ ایجاد شده برای درخواست.

Destination

الزامی. فهرست مقاصدی که کاربران باید از آنها حذف شوند.

AudienceMember

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

bool

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

Encoding

اختیاری. باید برای آپلودهای UserData ارائه شود. نوع رمزگذاری شناسه‌های کاربر. فقط برای رمزگذاری بیرونی برای شناسه‌های کاربر رمزگذاری شده اعمال می‌شود. برای آپلودهای غیر UserData ، این فیلد نادیده گرفته می‌شود.

EncryptionInfo

اختیاری. اطلاعات رمزگذاری برای آپلودهای UserData . اگر تنظیم نشود، فرض بر این است که اطلاعات شناسایی آپلود شده هش شده اما رمزگذاری نشده‌اند. برای آپلودهای غیر UserData ، این فیلد نادیده گرفته می‌شود.

string

شناسه‌ی خودکارِ ایجاد شده برای درخواست.

Destination

A destination within a DM API request.

RequestStatus

The request status of the destination.

ErrorInfo

An error info error containing the error reason and error counts related to the upload. Only populated if the request_status is FAILED or PARTIAL_SUCCESS . This field isn't populated while the request has request_status of PROCESSING .

WarningInfo

A warning info containing the warning reason and warning counts related to the upload. This field isn't populated while the request has request_status of PROCESSING .

IngestAudienceMembersStatus

The status of the ingest audience members request.

IngestEventsStatus

The status of the ingest events request.

RemoveAudienceMembersStatus

The status of the remove audience members request.

RemoveAllAudienceMembersStatus

The status of the remove all audience members request.

DataType

The type of data.

int64

The count for this data type.

IngestUserDataStatus

The status of the user data ingestion to the destination.

IngestMobileDataStatus

The status of the mobile data ingestion to the destination.

IngestPairDataStatus

The status of the pair data ingestion to the destination.

IngestUserIdDataStatus

The status of the user id data ingestion to the destination.

IngestPpidDataStatus

The status of the ppid data ingestion to the destination.

IngestCompositeDataStatus

The status of the composite data ingestion to the destination.

IngestGoogleUserIdDataStatus

The status of the google user id data ingestion to the destination.

IngestPartnerProvidedIdDataStatus

The status of the partner provided id data ingestion to the destination.

int64

The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.

DataTypeCount

The total count of data types sent in the upload request for the destination, broken down by data type. Includes all data types in the request, regardless of whether they were successfully ingested or not.

MatchRateRange

The match rate range of the upload.

int64

The total count of events sent in the upload request. Includes all events in the request, regardless of whether they were successfully ingested or not.

int64

The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.

int64

The total count of google user ids sent in the upload request for the destination. Includes all google user ids in the request, regardless of whether they were successfully ingested or not.

int64

The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.

int64

The total count of mobile ids sent in the upload request for the destination. Includes all mobile ids in the request, regardless of whether they were successfully ingested or not.

int64

The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.

int64

The total count of pair ids sent in the upload request for the destination. Includes all pair ids in the request, regardless of whether they were successfully ingested or not.

int64

The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.

int64

The total count of partner provided ids sent in the upload request for the destination. Includes all partner provided ids in the request, regardless of whether they were successfully ingested or not.

int64

The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.

int64

The total count of ppids sent in the upload request for the destination. Includes all ppids in the request, regardless of whether they were successfully ingested or not.

int64

The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.

int64

The total count of user identifiers sent in the upload request for the destination. Includes all user identifiers in the request, regardless of whether they were successfully ingested or not.

MatchRateRange

The match rate range of the upload.

int64

The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.

int64

The total count of user ids sent in the upload request for the destination. Includes all user ids in the request, regardless of whether they were successfully ingested or not.

RemoveUserDataStatus

The status of the user data removal from the destination.

RemoveMobileDataStatus

The status of the mobile data removal from the destination.

RemovePairDataStatus

The status of the pair data removal from the destination.

RemoveUserIdDataStatus

The status of the user id data removal from the destination.

RemovePpidDataStatus

The status of the ppid data removal from the destination.

RemoveCompositeDataStatus

The status of the composite data removal from the destination.

RemoveGoogleUserIdDataStatus

The status of the google user id data removal from the destination.

RemovePartnerProvidedIdDataStatus

The status of the partner provided id data removal from the destination.

int64

The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.

DataTypeCount

The total count of data types sent in the removal request, broken down by data type. Includes all data types in the request, regardless of whether they were successfully removed or not.

int64

The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.

int64

The total count of google user ids sent in the removal request. Includes all google user ids in the request, regardless of whether they were successfully removed or not.

int64

The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.

int64

The total count of mobile Ids sent in the removal request. Includes all mobile ids in the request, regardless of whether they were successfully removed or not.

int64

The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.

int64

The total count of pair ids sent in the removal request. Includes all pair ids in the request, regardless of whether they were successfully removed or not.

int64

The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.

int64

The total count of partner provided ids sent in the removal request. Includes all partner provided ids in the request, regardless of whether they were successfully removed or not.

int64

The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.

int64

The total count of ppids sent in the removal request. Includes all ppids in the request, regardless of whether they were successfully removed or not.

int64

The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.

int64

The total count of user identifiers sent in the removal request. Includes all user identifiers in the request, regardless of whether they were successfully removed or not.

int64

The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.

int64

The total count of user ids sent in the removal request. Includes all user ids in the request, regardless of whether they were successfully removed or not.

string

Required. The parent account that owns the user list. Format: accountTypes/{account_type}/accounts/{account}

Baseline

الزامی. خط پایه برای بینش‌های درخواستی.

string

الزامی. شناسه فهرست کاربری که اطلاعات آماری برای آن درخواست شده است.

MarketingDataInsight

شامل بینش‌هایی برای داده‌های بازاریابی است.

AudienceInsightsDimension

بُعدی که بصیرت به آن تعلق دارد.

MarketingDataInsightsAttribute

بینش‌هایی برای مقادیر یک بعد معین.

int64

شناسه‌ی علاقه‌مندی کاربر.

float

میزان رضایت مخاطب از مقدار ویژگی در مقایسه با خط پایه. محدوده [0-1].

AgeRange

محدوده سنی مخاطبانی که آسانسور برای آنها ارائه می‌شود.

Gender

جنسیت مخاطبانی که آسانسور برای آنها در نظر گرفته شده است.

string

Required. Required. The request ID of the Data Manager API request.

RequestStatusPerDestination

A list of request statuses per destination. The order of the statuses matches the order of the destinations in the original request.

string

Required. Account to search for partner links. If no filter is specified, all partner links where this account is either the owning_account or partner_account are returned.

Format: accountTypes/{account_type}/accounts/{account}

int32

حداکثر تعداد لینک‌های همکار برای برگرداندن. سرویس ممکن است کمتر از این مقدار را برگرداند. در صورت عدم تعیین، حداکثر ۵۰ لینک همکار برگردانده خواهد شد. حداکثر مقدار ۱۰۰ است؛ مقادیر بالاتر از ۱۰۰ به ۱۰۰ کاهش می‌یابد.

string

A page token, received from a previous SearchPartnerLinks call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to SearchPartnerLinks must match the call that provided the page token.

string

اختیاری. یک رشته فیلتر . همه فیلدها باید در سمت چپ هر شرط باشند (برای مثال: partner_link_id = 123456789 ). فیلدها باید با استفاده از تمام حالت‌های camel case یا snake case مشخص شوند. از ترکیب حالت‌های camel case و snake case استفاده نکنید.

عملیات پشتیبانی شده:

• AND
• =
• !=

فیلدهای پشتیبانی شده:

• partner_link_id
• owning_account.account_type
• owning_account.account_id
• partner_account.account_type
• partner_account.account_id
• feature_set

برای لینک‌های همکار با مجموعه ویژگی‌های FEATURE_SET_AD_EVENT_MANAGEMENT ، فیلدهای زیر نیز پشتیبانی می‌شوند:

• partner_customer_account.account_id
• partner_link_metadata.implicit_accounts.account_id

مثال: owning_account.account_type = "GOOGLE_ADS" AND partner_account.account_id = 987654321

PartnerLink

لینک‌های همکار برای حساب کاربری داده شده.

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

int64

Output only. Estimated number of members in this user list, on the Google Display Network.

int64

Output only. Estimated number of members in this user list in the google.com domain. These are the members available for targeting in Search campaigns.

int64

Output only. Estimated number of members in this user list on YouTube.

int64

Output only. Estimated number of members in this user list on Gmail.

bool

Output only. Indicates this user list is eligible for Google Display Network.

bool

Optional. Indicates if this user list is eligible for Google Search Network.

TermsOfServiceStatus

Optional. The Customer Match terms of service: https://support.google.com/adspolicy/answer/6299717 . This must be accepted when ingesting UserData or MobileData . This field is not required for Partner Match User list.

UserListDirectLicense

Required. The licenses' name field is used to identify the license to update.

FieldMask

Optional. The list of fields to update. The special character * is not supported and an INVALID_UPDATE_MASK error will be thrown if used.

UserListGlobalLicense

Required. The licenses' name field is used to identify the license to update.

FieldMask

Optional. The list of fields to update. The special character * is not supported and an INVALID_UPDATE_MASK error will be thrown if used.