متغيرات خدمة الموارد
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يُعدّ استخدام خدمة المورد الفردية الطريقة الأسهل لتعديل المورد، ولكنّها أيضًا الأقل مرونة.
نقاط نهاية التغيير
إنّ استخدام خدمة خاصة بمورد معيّن هو الطريقة الأسهل لتعديل البيانات.
يتضمّن كل مورد قابل للتغيير خدمة مرتبطة به ومجموعة من العمليات التي تتيح لك إنشاء المورد أو تعديله أو إزالته.
لنفترض أنّك تريد إنشاء Campaign جديد.
يمكنك إنشاء عنصر Campaign جديد، ووضعه داخل CampaignOperation، ثم إرساله إلى نقطة النهاية CampaignService.MutateCampaigns.
يمكنك إجراء ذلك لأي من خدمات Google Ads API. على سبيل المثال، إذا أردت تعديل AdGroup، عليك إرسال AdGroupOperation يحتوي على AdGroup المعدَّل إلى نقطة النهاية AdGroupService.MutateAdGroups.
وبالمثل، إذا أردت تعديل CampaignCriterion، عليك استخدام
CampaignCriterionOperation وإرساله إلى نقطة النهاية
CampaignCriterionService.MutateCampaignCriteria.
بما أنّه يمكن تكرار الحقل operations في الطلب، يمكن أن يحتوي طلب mutate واحد على عمليات متعددة. ومع ذلك، يتم التعامل مع كل عملية بشكل مستقل عن العمليات الأخرى، لذا لا يُسمح بالرجوع إلى عمليات أخرى.
يختلف ذلك عن طريقة التعديل المجمّع
(GoogleAdsService.Mutate)،
حيث يمكن أن تشير العمليات ضمن الطلب نفسه إلى عناصر من عمليات أخرى.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
