- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- CustomAudienceOperation
- MutateCustomAudienceResult
- آن را امتحان کنید!
مخاطبان سفارشی را ایجاد یا به روز می کند. وضعیت عملیات برگردانده می شود.
فهرست خطاهای پرتاب شده: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError داخلی خطا تغییر خطا عملیات دسترسی رد خط مشیخطا خطا QuotaError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}/customAudiences:mutate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
customerId | مورد نیاز. شناسه مشتری که مخاطبان سفارشی او در حال تغییر هستند. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"operations": [
{
object ( |
فیلدها | |
---|---|
operations[] | مورد نیاز. فهرست عملیاتی که باید روی مخاطبان سفارشی انجام شود. |
validateOnly | اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج. |
بدن پاسخگو
پیام پاسخ برای جهش مخاطب سفارشی.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"results": [
{
object ( |
فیلدها | |
---|---|
results[] | همه نتایج برای جهش. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
CustomAudienceOperation
یک عملیات واحد (ایجاد، به روز رسانی) روی یک مخاطب سفارشی.
نمایندگی JSON |
---|
{ "updateMask": string, // Union field |
فیلدها | |
---|---|
updateMask | FieldMask که تعیین می کند کدام فیلدهای منبع در یک به روز رسانی اصلاح می شوند. این فهرستی از نامهای فیلدهای کاملاً واجد شرایط با کاما است. مثال: |
operation میدانی اتحادیه عملیات جهش. operation می تواند تنها یکی از موارد زیر باشد: | |
create | ایجاد عملیات: هیچ نام منبعی برای مخاطبان سفارشی جدید انتظار نمی رود. |
update | عملیات به روز رسانی: انتظار می رود مخاطبان سفارشی نام منبع معتبری داشته باشند. |
remove | عملیات حذف: یک نام منبع برای مخاطبان سفارشی حذف شده انتظار می رود، در این قالب: |
MutateCustomAudienceResult
نتیجه برای مخاطبان سفارشی تغییر می کند.
نمایندگی JSON |
---|
{ "resourceName": string } |
فیلدها | |
---|---|
resourceName | برای عملیات موفقیت آمیز بازگشت. |