خدمات منبع تغییر می کند
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
استفاده از سرویس منفرد یک منبع، ساده ترین راه برای جهش آن است، اما کمترین انعطاف را نیز دارد.
نقاط پایانی را تغییر دهید
استفاده از یک سرویس خاص منبع، ساده ترین راه برای جهش است. هر منبع قابل تغییر دارای یک سرویس مربوطه و مجموعه ای از عملیات است که شما را قادر می سازد منبع را ایجاد، به روز رسانی یا حذف کنید.
فرض کنید می خواهید یک Campaign جدید ایجاد کنید. می‌توانید یک شی Campaign جدید ایجاد کنید، آن را در یک CampaignOperation قرار دهید و سپس آن را به نقطه پایانی CampaignService.MutateCampaigns ارسال کنید.
می توانید این کار را برای هر یک از سرویس های Google Ads API انجام دهید. بنابراین برای مثال، اگر می‌خواهید یک AdGroup را جهش دهید، یک AdGroupOperation حاوی AdGroup جهش یافته را به نقطه پایانی AdGroupService.MutateAdGroups ارسال می‌کنید.
به طور مشابه، اگر می‌خواهید یک CampaignCriterion تغییر دهید، باید از یک CampaignCriterionOperation استفاده کنید و آن را به نقطه پایانی CampaignCriterionService.MutateCampaignCriteria ارسال کنید.
از آنجایی که فیلد operations درخواست را می توان تکرار کرد، یک درخواست جهش واحد می تواند شامل چندین عملیات باشد. با این حال، هر عمل به طور مستقل از سایرین درمان می شود، بنابراین هیچ ارجاع متقابل مجاز نیست.
این برخلاف روش جهش انبوه ( GoogleAdsService.Mutate ) است، که در آن عملیات در همان درخواست می‌تواند به نهادهای عملیات دیگر ارجاع دهد.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe most straightforward way to mutate a resource is by using its individual service and corresponding operations (create, update, or remove).\u003c/p\u003e\n"],["\u003cp\u003eEach mutable resource has a dedicated service with specific endpoints for mutation, like \u003ccode\u003eCampaignService.MutateCampaigns\u003c/code\u003e for \u003ccode\u003eCampaign\u003c/code\u003e resources.\u003c/p\u003e\n"],["\u003cp\u003eA single mutate request to a resource-specific service can handle multiple operations, but each operation is treated independently.\u003c/p\u003e\n"],["\u003cp\u003eResource-specific mutation differs from bulk mutation (\u003ccode\u003eGoogleAdsService.Mutate\u003c/code\u003e) where operations can cross-reference each other within the same request.\u003c/p\u003e\n"]]],[],null,["# Resource Service Mutates\n\nUsing a resource's individual service is the most straightforward way to mutate\nit, but also the least flexible.\n\nMutate Endpoints\n----------------\n\nUsing a resource-specific service is the most straightforward way to mutate.\nEach mutable resource has a corresponding service and a set of operations that\nenable you to create, update, or remove the resource.\n\nSuppose you want to create a new [`Campaign`](/google-ads/api/reference/rpc/v21/Campaign).\nYou would create a new [`Campaign`](/google-ads/api/reference/rpc/v21/Campaign)\nobject, put it inside a [`CampaignOperation`](/google-ads/api/reference/rpc/v21/CampaignOperation),\nand then send it to the\n[`CampaignService.MutateCampaigns`](/google-ads/api/reference/rpc/v21/CampaignService/MutateCampaigns)\nendpoint.\n\nYou can do this for any of the Google Ads API services. So for example, if you wanted\nto mutate an [`AdGroup`](/google-ads/api/reference/rpc/v21/AdGroup), you would pass an\n[`AdGroupOperation`](/google-ads/api/reference/rpc/v21/AdGroupOperation) containing the\nmutated [`AdGroup`](/google-ads/api/reference/rpc/v21/AdGroup) to the\n[`AdGroupService.MutateAdGroups`](/google-ads/api/reference/rpc/v21/AdGroupService/MutateAdGroups) endpoint.\n\nSimilarly, if you want to modify a [`CampaignCriterion`](/google-ads/api/reference/rpc/v21/CampaignCriterion), you would use a\n[`CampaignCriterionOperation`](/google-ads/api/reference/rpc/v21/CampaignCriterionOperation) and send it to the\n[`CampaignCriterionService.MutateCampaignCriteria`](/google-ads/api/reference/rpc/v21/CampaignCriterionService/MutateCampaignCriteria) endpoint.\n\nSince the `operations` field of the request can be repeated, a single mutate\nrequest can contain multiple operations. However, each operation is treated\nindependently from all others, so no cross-referencing is allowed.\n\nThis is in contrast to the bulk mutate method\n([`GoogleAdsService.Mutate`](/google-ads/api/reference/rpc/v21/GoogleAdsService/Mutate)),\nwhere operations within the same request can reference entities from other\noperations."]]
