GetProfileDataFileUrl Hizmet İşlemi - Kampanya Yönetimi
Sektör veya iş işlevi profili verilerini indirmek için kullanabileceğiniz geçici bir URL alır.
İndirilen CSV dosyası , ProfileCriterion ile kullanabileceğiniz profil tanımlayıcılarını içerir.
Not
Profil verilerini şirket adına göre aramak için SearchCompanies işlemini kullanabilirsiniz.
İstek Öğeleri
GetProfileDataFileUrlRequest nesnesi, hizmet işlemi isteğinin gövde ve üst bilgi öğelerini tanımlar. Öğelerin İstek SOAP'sinde gösterildiği gibi aynı sırada olması gerekir.
Not
Aşağıda aksi belirtilmedikçe, tüm istek öğeleri gereklidir.
İstek Gövdesi Öğeleri
Öğe | Açıklama | Veri Türü |
---|---|---|
LanguageLocale | Profilin dili ve yerel ayarı adları görüntüler. Desteklenen dil yerel ayarı değerleri zh-Hant (Geleneksel Çince), en (İngilizce), fr (Fransızca), de (Almanca), it (İtalyanca), pt-BR (Brezilya Portekizcesi) ve es (İspanyolca). LinkedIn yerelleştirilmiş profil adını sağlamazsa, bunun varsayılan olarak evrensel ad (genellikle İngilizce olarak tanımlanır) olacağını unutmayın. |
dize |
ProfileType | Sektör veya iş işlevi profili verilerini isteyip istemediğinizi belirler. Bu hizmet işlemi için CompanyName profil türü desteklenmiyor. Profil verilerini şirket adına göre aramak için SearchCompanies işlemini kullanabilirsiniz. |
ProfileType |
İstek Üst Bilgisi Öğeleri
Öğe | Açıklama | Veri Türü |
---|---|---|
AuthenticationToken | Microsoft Advertising hesaplarına izinleri olan bir kullanıcının kimlik bilgilerini temsil eden OAuth erişim belirteci. Daha fazla bilgi için bkz. OAuth ile kimlik doğrulaması. |
dize |
CustomerAccountId | İstekteki varlıklara sahip olan veya bunlarla ilişkilendirilmiş reklam hesabının tanımlayıcısı. Her ikisi de gerektiğinde bu üst bilgi öğesi AccountId gövde öğesiyle aynı değere sahip olmalıdır. Bu öğe çoğu hizmet işlemi için gereklidir ve en iyi yöntem olarak her zaman ayarlamanız gerekir. Daha fazla bilgi için bkz. Hesabınızı ve Müşteri Kimliklerinizi Alma. |
dize |
CustomerId | Kullanıcının eriştiği veya faaliyette olduğu yönetici hesabının (müşteri) tanımlayıcısı. Bir kullanıcı birden çok yönetici hesabına erişebilir. Bu öğe çoğu hizmet işlemi için gereklidir ve en iyi yöntem olarak her zaman ayarlamanız gerekir. Daha fazla bilgi için bkz. Hesabınızı ve Müşteri Kimliklerinizi Alma. |
dize |
DeveloperToken | Bing Ads API'sine erişmek için kullanılan geliştirici belirteci. Daha fazla bilgi için bkz . Geliştirici Belirteci Alma. |
dize |
Password | Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir. | dize |
Kullanıcı adı | Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir. | dize |
Yanıt Öğeleri
GetProfileDataFileUrlResponse nesnesi, hizmet işlemi yanıtının gövde ve üst bilgi öğelerini tanımlar. Öğeler , Yanıt SOAP'sinde gösterildiği gibi aynı sırada döndürülür.
Yanıt Gövdesi Öğeleri
Öğe | Açıklama | Veri Türü |
---|---|---|
FileUrl | İstediğiniz profil türü, dil ve yerel ayar için profil verilerini indirmek için kullanabileceğiniz dosya URL'si. Dosyayı indirmeden önce , LastModifiedTimeUtc öğesinin tarih ve saatinin önceki indirmenizin tarih ve saatinden daha geç olup olmadığını denetleyin. Dosyayı yalnızca gerekirse indirmeniz gerekir. |
dize |
FileUrlExpiryTimeUtc | Sağlanan dosya URL'sinin süresinin dolacağı tarih ve saat. Dosyayı son kullanma tarihinden önce indirmezseniz, işlemi yeniden çağırarak yeni bir dosya URL'si isteyebilirsiniz. URL'nin bu işlemin tamamlanmasından 15 dakika sonra sona erecek şekilde ayarlandığını gözlemleyebilirsiniz; ancak, sabit bir süreye bağlı olmamalıdır. Gelecekte bu işleme yapılan çağrılar daha kısa veya daha uzun bir süre sonu ile sonuçlanabilir. Değer Eşgüdümlü Evrensel Saat (UTC) içindedir. Tarih ve saat değeri, istemcide değil sunucudaki tarih ve saati yansıtır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın. |
dateTime |
LastModifiedTimeUtc | Profil türü, dil ve yerel ayar için profil verilerinin son güncelleştirildiği tarih ve saat. En iyi yöntem olarak bu tarih ve saati depolamanız ve ileriye doğru yalnızca bu değerin daha sonraki bir tarih ve saate güncelleştirilmesi durumunda dosyayı indirmeniz gerekir. Değer Eşgüdümlü Evrensel Saat (UTC) içindedir. Tarih ve saat değeri, istemcide değil sunucudaki tarih ve saati yansıtır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın. |
dateTime |
Yanıt Üst Bilgisi Öğeleri
Öğe | Açıklama | Veri Türü |
---|---|---|
TrackingId | API çağrısının ayrıntılarını içeren günlük girdisinin tanımlayıcısı. | dize |
SOAP isteme
Bu şablon, SOAP isteği için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur. Bu hizmet işlemiyle kullanabileceğiniz desteklenen türler için yukarıdaki İstek Gövdesi Öğeleri başvurusuna bakın.
<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<Action mustUnderstand="1">GetProfileDataFileUrl</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
<CustomerId i:nil="false">ValueHere</CustomerId>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<GetProfileDataFileUrlRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<LanguageLocale i:nil="false">ValueHere</LanguageLocale>
<ProfileType>ValueHere</ProfileType>
</GetProfileDataFileUrlRequest>
</s:Body>
</s:Envelope>
Yanıt SOAP
Bu şablon, SOAP yanıtı için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
</s:Header>
<s:Body>
<GetProfileDataFileUrlResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<FileUrl d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</FileUrl>
<FileUrlExpiryTimeUtc d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</FileUrlExpiryTimeUtc>
<LastModifiedTimeUtc>ValueHere</LastModifiedTimeUtc>
</GetProfileDataFileUrlResponse>
</s:Body>
</s:Envelope>
Kod Söz Dizimi
Örnek söz dizimi Bing Reklam SDK'ları ile kullanılabilir. Daha fazla örnek için bkz . Bing Ads API Kod Örnekleri .
public async Task<GetProfileDataFileUrlResponse> GetProfileDataFileUrlAsync(
string languageLocale,
ProfileType profileType)
{
var request = new GetProfileDataFileUrlRequest
{
LanguageLocale = languageLocale,
ProfileType = profileType
};
return (await CampaignManagementService.CallAsync((s, r) => s.GetProfileDataFileUrlAsync(r), request));
}
static GetProfileDataFileUrlResponse getProfileDataFileUrl(
java.lang.String languageLocale,
ArrayList<ProfileType> profileType) throws RemoteException, Exception
{
GetProfileDataFileUrlRequest request = new GetProfileDataFileUrlRequest();
request.setLanguageLocale(languageLocale);
request.setProfileType(profileType);
return CampaignManagementService.getService().getProfileDataFileUrl(request);
}
static function GetProfileDataFileUrl(
$languageLocale,
$profileType)
{
$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];
$request = new GetProfileDataFileUrlRequest();
$request->LanguageLocale = $languageLocale;
$request->ProfileType = $profileType;
return $GLOBALS['CampaignManagementProxy']->GetService()->GetProfileDataFileUrl($request);
}
response=campaignmanagement_service.GetProfileDataFileUrl(
LanguageLocale=LanguageLocale,
ProfileType=ProfileType)
Gereksinimler
Hizmet: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13
İstek Url'si
https://campaign.api.bingads.microsoft.com/CampaignManagement/v13/ProfileDataFileUrl/Query
İstek Öğeleri
GetProfileDataFileUrlRequest nesnesi, hizmet işlemi isteğinin gövde ve üst bilgi öğelerini tanımlar.
Not
Aşağıda aksi belirtilmedikçe, tüm istek öğeleri gereklidir.
İstek Gövdesi Öğeleri
Öğe | Açıklama | Veri Türü |
---|---|---|
LanguageLocale | Profilin dili ve yerel ayarı adları görüntüler. Desteklenen dil yerel ayarı değerleri zh-Hant (Geleneksel Çince), en (İngilizce), fr (Fransızca), de (Almanca), it (İtalyanca), pt-BR (Brezilya Portekizcesi) ve es (İspanyolca). LinkedIn yerelleştirilmiş profil adını sağlamazsa, bunun varsayılan olarak evrensel ad (genellikle İngilizce olarak tanımlanır) olacağını unutmayın. |
dize |
ProfileType | Sektör veya iş işlevi profili verilerini isteyip istemediğinizi belirler. Bu hizmet işlemi için CompanyName profil türü desteklenmiyor. Profil verilerini şirket adına göre aramak için SearchCompanies işlemini kullanabilirsiniz. |
ProfileType |
İstek Üst Bilgisi Öğeleri
Öğe | Açıklama | Veri Türü |
---|---|---|
İzin | Microsoft Advertising hesaplarına izinleri olan bir kullanıcının kimlik bilgilerini temsil eden OAuth erişim belirteci. Belirtecin ön ekinin "Taşıyıcı" olduğundan emin olun, bu doğru kimlik doğrulaması için gereklidir. Daha fazla bilgi için bkz. OAuth ile kimlik doğrulaması. |
dize |
CustomerAccountId | İstekteki varlıklara sahip olan veya bunlarla ilişkilendirilmiş reklam hesabının tanımlayıcısı. Her ikisi de gerektiğinde bu üst bilgi öğesi AccountId gövde öğesiyle aynı değere sahip olmalıdır. Bu öğe çoğu hizmet işlemi için gereklidir ve en iyi yöntem olarak her zaman ayarlamanız gerekir. Daha fazla bilgi için bkz. Hesabınızı ve Müşteri Kimliklerinizi Alma. |
dize |
CustomerId | Kullanıcının eriştiği veya faaliyette olduğu yönetici hesabının (müşteri) tanımlayıcısı. Bir kullanıcı birden çok yönetici hesabına erişebilir. Bu öğe çoğu hizmet işlemi için gereklidir ve en iyi yöntem olarak her zaman ayarlamanız gerekir. Daha fazla bilgi için bkz. Hesabınızı ve Müşteri Kimliklerinizi Alma. |
dize |
DeveloperToken | Bing Ads API'sine erişmek için kullanılan geliştirici belirteci. Daha fazla bilgi için bkz . Geliştirici Belirteci Alma. |
dize |
Password | Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir. | dize |
Kullanıcı adı | Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir. | dize |
Yanıt Öğeleri
GetProfileDataFileUrlResponse nesnesi, hizmet işlemi yanıtının gövde ve üst bilgi öğelerini tanımlar. Öğeler , Yanıt JSON'unda gösterildiği gibi aynı sırada döndürülür.
Yanıt Gövdesi Öğeleri
Öğe | Açıklama | Veri Türü |
---|---|---|
FileUrl | İstediğiniz profil türü, dil ve yerel ayar için profil verilerini indirmek için kullanabileceğiniz dosya URL'si. Dosyayı indirmeden önce , LastModifiedTimeUtc öğesinin tarih ve saatinin önceki indirmenizin tarih ve saatinden daha geç olup olmadığını denetleyin. Dosyayı yalnızca gerekirse indirmeniz gerekir. |
dize |
FileUrlExpiryTimeUtc | Sağlanan dosya URL'sinin süresinin dolacağı tarih ve saat. Dosyayı son kullanma tarihinden önce indirmezseniz, işlemi yeniden çağırarak yeni bir dosya URL'si isteyebilirsiniz. URL'nin bu işlemin tamamlanmasından 15 dakika sonra sona erecek şekilde ayarlandığını gözlemleyebilirsiniz; ancak, sabit bir süreye bağlı olmamalıdır. Gelecekte bu işleme yapılan çağrılar daha kısa veya daha uzun bir süre sonu ile sonuçlanabilir. Değer Eşgüdümlü Evrensel Saat (UTC) içindedir. Tarih ve saat değeri, istemcide değil sunucudaki tarih ve saati yansıtır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın. |
dateTime |
LastModifiedTimeUtc | Profil türü, dil ve yerel ayar için profil verilerinin son güncelleştirildiği tarih ve saat. En iyi yöntem olarak bu tarih ve saati depolamanız ve ileriye doğru yalnızca bu değerin daha sonraki bir tarih ve saate güncelleştirilmesi durumunda dosyayı indirmeniz gerekir. Değer Eşgüdümlü Evrensel Saat (UTC) içindedir. Tarih ve saat değeri, istemcide değil sunucudaki tarih ve saati yansıtır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın. |
dateTime |
Yanıt Üst Bilgisi Öğeleri
Öğe | Açıklama | Veri Türü |
---|---|---|
TrackingId | API çağrısının ayrıntılarını içeren günlük girdisinin tanımlayıcısı. | dize |
JSON isteme
Bu şablon, JSON isteğinin gövde ve üst bilgi öğelerini gösteren bir araç tarafından oluşturulmuştur. Bu hizmet işlemiyle kullanabileceğiniz desteklenen türler için yukarıdaki İstek Gövdesi Öğeleri başvurusuna bakın.
{
"LanguageLocale": "ValueHere",
"ProfileType": "ValueHere"
}
Yanıt JSON
Bu şablon, JSON yanıtının gövde ve üst bilgi öğelerini göstermek için bir araç tarafından oluşturulmuştur.
{
"FileUrl": "ValueHere",
"FileUrlExpiryTimeUtc": "ValueHere",
"LastModifiedTimeUtc": "ValueHere"
}
Kod Söz Dizimi
SDK'lar aracılığıyla REST API'yi çağırmak için SDK'yı belirli bir sürüme yükseltmeniz ve sistem parametrelerini yapılandırmanız gerekir. Örnek söz dizimi Bing Reklam SDK'ları ile kullanılabilir. Daha fazla örnek için bkz . Bing Ads API Kod Örnekleri .
public async Task<GetProfileDataFileUrlResponse> GetProfileDataFileUrlAsync(
string languageLocale,
ProfileType profileType)
{
var request = new GetProfileDataFileUrlRequest
{
LanguageLocale = languageLocale,
ProfileType = profileType
};
return (await CampaignManagementService.CallAsync((s, r) => s.GetProfileDataFileUrlAsync(r), request));
}
static GetProfileDataFileUrlResponse getProfileDataFileUrl(
java.lang.String languageLocale,
ArrayList<ProfileType> profileType) throws RemoteException, Exception
{
GetProfileDataFileUrlRequest request = new GetProfileDataFileUrlRequest();
request.setLanguageLocale(languageLocale);
request.setProfileType(profileType);
return CampaignManagementService.getService().getProfileDataFileUrl(request);
}
static function GetProfileDataFileUrl(
$languageLocale,
$profileType)
{
$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];
$request = new GetProfileDataFileUrlRequest();
$request->LanguageLocale = $languageLocale;
$request->ProfileType = $profileType;
return $GLOBALS['CampaignManagementProxy']->GetService()->GetProfileDataFileUrl($request);
}
response=campaignmanagement_service.GetProfileDataFileUrl(
LanguageLocale=LanguageLocale,
ProfileType=ProfileType)