Noms des ressources
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'identifiant unique d'une entité dans l'API Google Ads est appelé nom de ressource. Il est représenté sous la forme d'une chaîne avec un format prévisible. Si vous connaissez les composants d'un nom de ressource, vous pouvez générer des noms de ressources à l'aide des méthodes d'assistance présentes sur de nombreux objets de service.
Méthodes de chemin de service
Tous les services conçus pour gérer la lecture ou la modification de types d'objets spécifiques dans l'API disposent de méthodes d'assistance pour construire des resource_names. Par exemple, vous pouvez créer un nom de ressource pour un objet Campaign :
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
customer_id = "7892134783"
campaign_id = "1234567890"
campaign_service = client.get_service("CampaignService")
resource_name = campaign_service.campaign_path(customer_id, campaign_id)
Chaque service dispose également d'une méthode parse_*_path associée qui déconstruit un resource_name en segments individuels, par exemple :
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
resource_name = "customers/7892134783/campaigns/1234567890"
campaign_service = client.get_service('CampaignService')
segments = campaign_service.parse_campaign_path(resource_name)
customer_id = segments["customer_id"]
campaign_id = segments["campaign_id"]
Noms de ressources composites
Les helpers de chemin d'accès sur les services construisent des segments composites d'un nom de ressource. Les différents segments de l'ID composite sont acceptés en tant que paramètres individuels dans la méthode :
from google.ads.google_ads.client import GoogleAdsClient
customer_id = "0987654321"
ad_group_id = "1234567890"
criterion_id = "74932"
client = GoogleAdsClient.load_from_storage()
ad_group_criterion_service = client.get_service("AdGroupCriterionService")
# An AdGroupCriterion resource name that uses the above IDs looks like this:
# "customers/0987654321/adGroupCriteria/1234567890~74932"
resource_name = ad_group_criterion_service.ad_group_criterion_path(
customer_id, ad_group_id, criterion_id
)
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/27 (UTC).
[null,null,["Dernière mise à jour le 2025/08/27 (UTC)."],[[["\u003cp\u003eIn the Google Ads API, entities are uniquely identified by a predictable string format called a resource name.\u003c/p\u003e\n"],["\u003cp\u003eHelper methods on Service objects can be used to generate these resource names if you know the required components.\u003c/p\u003e\n"],["\u003cp\u003eServices offer path methods like \u003ccode\u003ecampaign_path\u003c/code\u003e to build resource names and \u003ccode\u003eparse_campaign_path\u003c/code\u003e to break them down into individual segments.\u003c/p\u003e\n"],["\u003cp\u003eComposite resource names, such as those for AdGroupCriterion, are constructed by path helpers using multiple ID segments as parameters.\u003c/p\u003e\n"]]],[],null,["# Resource Names\n\nThe unique identifier for an entity in the Google Ads API is called a resource\nname, and is represented as a string with a predictable format. If you know\nthe constituent components of a resource name, you can generate resource names\nusing helper methods present on many Service objects.\n\nService path methods\n--------------------\n\nAll Services that are designed to handle reading or mutating specific types of\nobjects in the API have helper methods to construct resource_names. For example,\nyou can create a resource name for a `Campaign` object: \n\n from google.ads.googleads.client import GoogleAdsClient\n\n client = GoogleAdsClient.load_from_storage()\n customer_id = \"7892134783\"\n campaign_id = \"1234567890\"\n campaign_service = client.get_service(\"CampaignService\")\n resource_name = campaign_service.campaign_path(customer_id, campaign_id)\n\nEach service also has an accompanying `parse_*_path` method that deconstructs a\nresource_name into its individual segments, for example: \n\n from google.ads.googleads.client import GoogleAdsClient\n\n client = GoogleAdsClient.load_from_storage()\n resource_name = \"customers/7892134783/campaigns/1234567890\"\n campaign_service = client.get_service('CampaignService')\n segments = campaign_service.parse_campaign_path(resource_name)\n customer_id = segments[\"customer_id\"]\n campaign_id = segments[\"campaign_id\"]\n\nComposite resource names\n------------------------\n\nPath helpers on services construct composite segments of a resource name. The\ndifferent segments of the composite ID are accepted as individual parameters in\nthe method: \n\n from google.ads.google_ads.client import GoogleAdsClient\n\n customer_id = \"0987654321\"\n ad_group_id = \"1234567890\"\n criterion_id = \"74932\"\n\n client = GoogleAdsClient.load_from_storage()\n ad_group_criterion_service = client.get_service(\"AdGroupCriterionService\")\n\n # An AdGroupCriterion resource name that uses the above IDs looks like this:\n # \"customers/0987654321/adGroupCriteria/1234567890~74932\"\n resource_name = ad_group_criterion_service.ad_group_criterion_path(\n customer_id, ad_group_id, criterion_id\n )"]]
