تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك استخدام GoogleAdsFieldService
لطلب الكتالوج بشكل ديناميكي للحصول على المراجع وحقول المراجع ومفاتيح التقسيم والمقاييس المتاحة في طريقتَي
GoogleAdsServiceSearch و
SearchStream. يوفّر الفهرس بيانات وصفية يمكن أن يستخدمها عملاء Google Ads API للتحقّق من صحة عبارات "لغة طلب البحث في إعلانات Google" وإنشائها.
نموذج لطلب واستجابة HTTP
يتألف الطلب من HTTP GET إلى خادم Google Ads API على عنوان URL التالي:
المراجع التي يمكن ربطها ضمنيًا بالمرجع في عبارة FROM.
metrics
المقاييس التي يمكن تحديدها مع المرجع في عبارة FROM لا تتم تعبئة هذا الحقل إلا للحقول التي تكون فيها قيمة category هي RESOURCE.
segments
مفاتيح الأقسام التي يمكن اختيارها مع المرجع في عبارة FROM
تؤدي هذه السمات إلى تقسيم المقاييس المحدّدة في طلب البحث. لا تتم تعبئة هذا الحقل إلا للحقول التي تكون فيها قيمة category هي RESOURCE.
selectableWith
الحقول التي يمكن اختيارها إلى جانب حقل معيّن، عندما لا تكون في عبارة FROM
لا تكون هذه السمة ذات صلة إلا عند تحديد المراجع أو الأقسام التي يمكن اختيارها في طلب بحث لا يتم تضمينها فيه من خلال المرجع في عبارة FROM. على سبيل المثال، إذا كنا نختار ad_group.id
وsegments.date من ad_group، وأردنا تضمين سمات من campaign، علينا التأكّد من أنّ segments.date مضمّنة في السمة selectableWith للحملة، لأنّه يتم اختيارها إلى جانب الحقل segments.date الحالي.
تفاصيل البيانات الوصفية
يمكنك طلب الفهرس باستخدام GoogleAdsFieldService على المستويات التالية:
المرجع
على سبيل المثال، googleAdsFields/campaign.
حقل المرجع
على سبيل المثال، googleAdsFields/campaign.name.
حقل التقسيم
على سبيل المثال، googleAdsFields/segments.ad_network_type.
تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eUse \u003ccode\u003eGoogleAdsFieldService\u003c/code\u003e to retrieve metadata for resources, fields, segments, and metrics available in Google Ads API Search methods.\u003c/p\u003e\n"],["\u003cp\u003eThe catalog provides data for validation and Google Ads Query Language statement construction, useful for Google Ads API clients.\u003c/p\u003e\n"],["\u003cp\u003eRequest metadata details using resource, resource's field, segmentation field, or metric levels through \u003ccode\u003eGoogleAdsFieldService\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eImportant arrays include: \u003ccode\u003eattributeResources\u003c/code\u003e for implicit joins, \u003ccode\u003emetrics\u003c/code\u003e and \u003ccode\u003esegments\u003c/code\u003e available for selection, and \u003ccode\u003eselectableWith\u003c/code\u003e for fields selectable alongside others.\u003c/p\u003e\n"],["\u003cp\u003eWhile the example uses HTTP/JSON, using client libraries based on gRPC is recommended for submitting requests.\u003c/p\u003e\n"]]],[],null,["# Resource Metadata\n\nYou can use [`GoogleAdsFieldService`](/google-ads/api/reference/rpc/v21/GoogleAdsFieldService)\nto dynamically request the catalog for resources, resource's fields,\nsegmentation keys and metrics available in the\n[`GoogleAdsService`](/google-ads/api/reference/rpc/v21/GoogleAdsService) *Search* and\n*SearchStream* methods. The catalog provides metadata that can be used by\nGoogle Ads API clients for validation and construction of Google Ads Query Language statements.\n\nSample HTTP request and response\n--------------------------------\n\n| **Note:** The example shows the underlying HTTP/JSON request as a guide, but you are strongly encouraged to use one of the [client libraries](/google-ads/api/docs/client-libs) based on [gRPC](//grpc.io) to submit your requests.\n\nThe request consists of an `HTTP GET` to the Google Ads API server at the following\nURL: \n\n https://googleads.googleapis.com/v21/googleAdsFields/{resource_or_field}\n\nThe following example shows a request followed by the response returned from\n`GoogleAdsFieldService` for the **ad_group** resource:\n\n### Request\n\n https://googleads.googleapis.com/v21/googleAdsFields/ad_group\n\n### Response\n\n {\n \"resourceName\": \"googleAdsFields/ad_group\",\n \"name\": \"ad_group\",\n \"category\": \"RESOURCE\",\n \"selectable\": false,\n \"filterable\": false,\n \"sortable\": false,\n \"selectableWith\": [\n \"campaign\",\n \"customer\",\n \"metrics.average_cpc\",\n \"segments.device\",\n ...\n ],\n \"attributeResources\": [\n \"customer\",\n \"campaign\"\n ],\n\n \"metrics\": [\n \"metrics.conversions\",\n \"metrics.search_budget_lost_impression_share\",\n \"metrics.average_cost\",\n \"metrics.clicks\",\n ...\n ],\n \"segments\": [\n \"segments.date\",\n \"segments.ad_network_type\",\n \"segments.device\",\n ...\n ]\n }\n\nFor this example, the important arrays are:\n\n`attributeResources`\n: Resources that can be implicitly joined to the resource in the `FROM`\n clause.\n\n`metrics`\n: Metrics that are available to be selected with the resource in the `FROM`\n clause. Only populated for fields where the `category` is `RESOURCE`.\n\n`segments`\n: Segment keys that can be selected with the resource in the `FROM` clause.\n These segment the metrics specified in the query. Only populated for fields\n where the `category` is `RESOURCE`.\n\n`selectableWith`\n\n: Fields that can be selected alongside a given field, when not in the `FROM`\n clause. This attribute is only relevant when identifying resources or segments\n that are able to be selected in a query where they are not included by the\n resource in the `FROM` clause. As an example, if we are selecting `ad_group.id`\n and `segments.date` from `ad_group`, and we want to include attributes from\n `campaign`, we would need to check that `segments.date` is in the\n `selectableWith` attribute for campaign, since it's being selected alongside\n the existing `segments.date` field.\n\nMetadata details\n----------------\n\nYou can request the catalog using the `GoogleAdsFieldService` at these levels:\n\nResource\n: For example, `googleAdsFields/campaign`.\n\nResource's field\n: For example, `googleAdsFields/campaign.name`.\n\nSegmentation field\n: For example, `googleAdsFields/segments.ad_network_type`.\n\nMetric\n: For example, `googleAdsFields/metrics.clicks`."]]
