أسماء الموارد
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توفّر الأداة المساعدة
ResourceNames
طريقة لإنشاء اسم المورد الخاص بأحد العناصر إذا كنت تعرف كل المعرّفات ذات الصلة بهذا العنصر. على سبيل المثال، يكون اسم مورد الحملة بالتنسيق customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>
، لذا إذا كنت تعرف رقم تعريف العميل ورقم تعريف الحملة، يمكنك استخدام الأداة المساعدة ResourceNames
لإنشاء اسم المورد الكامل.
بشرط أن يحتوي $customerId
على رقم تعريف العميل وأن يحتوي $campaignId
على رقم تعريف الحملة، يمكنك استخدام forCampaign للحصول على اسم مورد الحملة كما هو موضّح أدناه:
$campaignResourceName = ResourceNames::forCampaign($customerId, $campaignId)
لكل كيان مجموعة مختلفة من المعرّفات التي يتكوّن منها اسم المورد. على سبيل المثال، يحتاج اسم المورد الخاص بمعيار مجموعة إعلانية إلى رقم تعريف عميل ورقم تعريف مجموعة إعلانية ورقم تعريف معيار مجموعة إعلانية.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003eResourceNames\u003c/code\u003e utility helps build resource names for Google Ads entities using their respective IDs.\u003c/p\u003e\n"],["\u003cp\u003eYou need to provide the necessary IDs, like customer ID and campaign ID, to construct a specific resource name.\u003c/p\u003e\n"],["\u003cp\u003eEach Google Ads entity type has a unique set of IDs required for its resource name, such as ad group criteria needing customer ID, ad group ID, and criterion ID.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eResourceNames\u003c/code\u003e offers functions like \u003ccode\u003eforCampaign\u003c/code\u003e to easily generate resource names for specific entities.\u003c/p\u003e\n"]]],[],null,["# Resource Names\n\nThe\n[ResourceNames](https://github.com/googleads/google-ads-php/blob/HEAD/src/Google/Ads/GoogleAds/Util/V21/ResourceNames.php)\nutility is a way to construct the resource name of an entity if you know all of\nthe relevant IDs related to that entity. For example, a campaign resource name\nis in the format `customers/\u003cCUSTOMER_ID\u003e/campaigns/\u003cCAMPAIGN_ID\u003e`, so if you\nknow the customer ID and the campaign ID, you can use the `ResourceNames`\nutility to construct the full resource name.\n\nProvided that `$customerId` contains your customer ID and `$campaignId` contains\nyour campaign ID, you can use\n[forCampaign](https://github.com/googleads/google-ads-php/blob/HEAD/src/Google/Ads/GoogleAds/Util/V21/ResourceNames.php#L141)\nto get the resource name of the campaign as shown below: \n\n $campaignResourceName = ResourceNames::forCampaign($customerId, $campaignId)\n\nEach entity has a different set of IDs that composes the resource name. For\ninstance, the resource name of an ad group criterion needs a customer ID, ad\ngroup ID, and ad group criterion ID."]]