تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح واجهة Google Ads API استخدام مواد العرض الآلية التي تديرها "إعلانات Google" مباشرةً، مع حصر نطاق واجهة برمجة التطبيقات على إيقاف مواد العرض الفردية مؤقتًا أو إزالتها واسترداد الإحصاءات. يمكنك تفعيل مواد العرض التلقائية أو إيقافها من خلال واجهة الويب الخاصة بـ "إعلانات Google".
الإنشاء والتعديل
بعد تفعيل هذه الميزة في أحد الحسابات، تنشئ "إعلانات Google" مواد عرض تلقائية على النحو التالي:
لا يمكنك إنشاء مواد عرض مبرمَجة أو تعديلها باستخدام Google Ads API، كما لا يمكنك إنشاء CampaignAsset أو AdGroupAsset أو CustomerAsset لمواد العرض المبرمَجة باستخدام Google Ads API.
يؤدي إيقاف الربط مؤقتًا إلى منع عرض مادة العرض مع الجهة المعنية بشكل مؤقت. بعد إيقاف الربط مؤقتًا، لن تعيد "إعلانات Google" تلقائيًا تفعيل مادة العرض المقابلة أو عرضها مقابل هذا المرجع إلى أن تتم إعادة تفعيلها من خلال واجهة الويب أو واجهة برمجة التطبيقات. لإيقاف الربط بين مادة العرض والمصدر نهائيًا، عليك إزالة عملية الربط.
تفرض "إعلانات Google" حدًا أقصى على عدد مواد العرض المبرمَجة من نوع معيّن والتي يمكن ربطها بكيان معيّن، مثل عدد روابط الموقع المبرمَجة لكل حملة. يتم احتساب الربط المتوقّف مؤقتًا ضمن هذا الحدّ، بينما لا يتم احتساب الربط الذي تمت إزالته. لا يتم احتساب مواد العرض التلقائية ضمن الحدود المسموح بها لمواد العرض المضافة يدويًا.
استرداد مواد العرض التلقائية
يمكنك استرداد بيانات مواد العرض التلقائية من خلال الفلترة حسب
AssetSource = AUTOMATICALLY_CREATED.
بالنسبة إلى مواد العرض التي يمكن ربطها بالإعلانات، تحقَّق من
source. راجِع
AssetType للاطّلاع على قائمة بأنواع مواد العرض
التي يمكن ربطها بالإعلانات.
يمكن طلب إحصاءات أداء مواد العرض من تقرير
asset_field_type_view. يتضمّن هذا التقرير الإحصاءات المجمّعة لكلّ من مواد العرض المبرمَجة وتلك التي تمت إضافتها يدويًا.
تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Ads API allows you to manage automated assets (created by Google Ads) by pausing, removing, or retrieving their performance data.\u003c/p\u003e\n"],["\u003cp\u003eYou can opt in or out of using automated assets through the Google Ads web interface, but cannot create or update them directly via the API.\u003c/p\u003e\n"],["\u003cp\u003ePausing an automated asset's association with a campaign, ad group, or customer temporarily disables it, while removing the association permanently disables it.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve data for automated assets using specific queries and filters within the Google Ads API.\u003c/p\u003e\n"],["\u003cp\u003ePerformance statistics for automated assets are available through various reporting features within the Google Ads API, including aggregated and individual asset data.\u003c/p\u003e\n"]]],[],null,["# Automated assets\n\nThe Google Ads API supports [automated\nassets](//support.google.com/google-ads/answer/7175034) managed directly by\nGoogle Ads, with the scope of the API limited to pausing or removing individual\nassets and retrieving stats. You opt in or out of automated assets through the\nGoogle Ads web interface.\n\nCreation and update\n-------------------\n\nOnce an account is opted in to this feature, Google Ads creates automated assets as\nfollows:\n\n1. Assets are created.\n2. [`CampaignAsset`](/google-ads/api/reference/rpc/v21/CampaignAsset), [`AdGroupAsset`](/google-ads/api/reference/rpc/v21/AdGroupAsset), or [`CustomerAsset`](/google-ads/api/reference/rpc/v21/CustomerAsset) objects are created to associate the asset with campaign, ad group, or customer resources, respectively.\n\nYou cannot create or update automated assets using the Google Ads API, nor can you\ncreate [`CampaignAsset`](/google-ads/api/reference/rpc/v21/CampaignAsset),\n[`AdGroupAsset`](/google-ads/api/reference/rpc/v21/AdGroupAsset), or\n[`CustomerAsset`](/google-ads/api/reference/rpc/v21/CustomerAsset) for the automated assets using\nthe Google Ads API.\n\nYou can pause or remove [`CampaignAsset`](/google-ads/api/reference/rpc/v21/CampaignAsset),\n[`AdGroupAsset`](/google-ads/api/reference/rpc/v21/AdGroupAsset), or\n[`CustomerAsset`](/google-ads/api/reference/rpc/v21/CustomerAsset) entities that associate the\nautomated asset with the corresponding resource.\n\nPause or remove the association\n-------------------------------\n\nPausing the association disables the asset from serving against the\ncorresponding entity temporarily. Once you pause the association, Google Ads won't\nautomatically re-enable or serve the corresponding asset against that resource\nuntil it is re-enabled through the web interface or API. To disable the\nassociation between asset and resource permanently, remove the association.\n\nGoogle Ads enforces a limit on the number of automated assets of a given type that\ncan be associated with a given entity, for example, the number of automated\nsitelinks per campaign. A paused association counts against this limit, whereas\na removed association doesn't. Automated assets don't count towards the limits\nfor manually added assets.\n\nRetrieve automated assets\n-------------------------\n\nYou can retrieve automated assets data by filtering for\n[`AssetSource = AUTOMATICALLY_CREATED`](/google-ads/api/reference/rpc/v21/AssetSourceEnum.AssetSource#automatically_created).\nFor assets that can link to ads, check its\n[`source`](/google-ads/api/reference/rpc/v21/AdGroupAdAssetView#source). Refer to\n[`AssetType`](/google-ads/api/reference/rpc/v21/AssetTypeEnum.AssetType) for a list of asset types\nthat can be linked to ads.\n\nHere is a sample query for assets in an ad: \n\n SELECT\n ad_group.name,\n ad_group_ad_asset_view.asset,\n ad_group_ad_asset_view.ad_group_ad\n FROM ad_group_ad_asset_view\n WHERE asset.source = 'AUTOMATICALLY_CREATED'\n\nFor other types of assets, query the [`Asset`](/google-ads/api/reference/rpc/v21/Asset) resource\ndirectly: \n\n SELECT\n asset.id,\n asset.name\n FROM asset\n WHERE asset.source = 'AUTOMATICALLY_CREATED'\n\nReports\n-------\n\nAsset performance statistics can be requested from the\n[`asset_field_type_view`](/google-ads/api/fields/v21/asset_field_type_view) report. This report\nincludes the aggregated stats for both automated and manually added assets.\n\nPerformance stats for individual assets can be retrieved from the\n[`campaign_asset`](/google-ads/api/fields/v21/campaign_asset),\n[`customer_asset`](/google-ads/api/fields/v21/customer_asset), and\n[`ad_group_asset`](/google-ads/api/fields/v21/ad_group_asset) reports."]]
